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Chapter 1. Introduction 


This book describes the Operating System/2 (OS/2) Version 1.2 language binding for IBM C/2. 

It provides language-dependent information about the functions described in the OS/2 Version 1.2 
Presentation Manager Programming Reference . 

The information in this book, together with the functional descriptions detailed in the Presentation 
Manager Programming Reference , enable the user to generate call statements in C. 

The following information is provided: 

• The syntax of each data type and structure 

• The parameter list for each call. 


Header Files 

All functions require an ‘'include” for the system header file OS2.H: 

#include <0S2.H> 

Also, most functions require a “define” to select an appropriate (conditional) section of the header 
file, and hence, the required entry point Where this is necessary, it is shown at the head of the func- 
tion definition in the form: 

#define INCLjfiame 

Programming Note: These “#defines” must precede the “#inciude <OS2.H> ." 


APIENTRY 

Unless shown otherwise, all functions have an implicit type of APIENTRY, which is defined in the 
system header file OS2.H as: 

#define APIENTRY pascal far 


Miscellaneous Definitions 

The following definitions are provided in the system header file OS2.H: 


#def i ne 

FALSE 

0 

#def i ne 

TRUE 

1 

#define 

NULL 

0 

#define 

FAR 

far 

#define 

NEAR 

near 

#define 

PASCAL 

pascal 
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IBM C/2 Data Types 

If you are writing an application in IBM C/2, the Pascal calling conventions must be used. IBM C/2, 
unlike other high-level languages, pushes the parameters for each subroutine from right to left onto a 
stack. The calling application rather than the called subroutine must remove the arguments from the 
stack. 

In the case of messages, the parameters paraml, param2, and reply can be a combination of several 
pieces of information. These parameters contain one of the following: 

• A simple data type, that can be constructed or analyzed by means of C data declaration facilities 

• A combination of simple data types, that can be constructed or analyzed by means of C data 
declaration facilities 

• A pointer to a compound data type, that can be constructed or analyzed by means of the corre- 
sponding compound data type. 


Helper Macros 

A series of macros is defined for packing data into, and extracting data from, variables of MPARAM 
and MRESULT data types. They are used in conjunction with the WinSendMsg and the other 
message functions, and also inside window and dialog procedures. 

These macros always cast their arguments to the specified type, so values of any of the types speci- 
fied for each macro may be passed without additional casting. NULL may be used to pass unused 
parameter data. 

Macros for packing data into a MPARAM variable: 


/* Used to pass any pointer type: */ 

#define MPFROMP(p) ((MPARAM) (VOID FAR *)(p)) 

/* Used to pass a window handle: */ 

#define MPFROMHWND(hwnd) ((MPARAM) (HWND) (hwnd)) 

/* Used to pass a CHAR, UCHAR, or BYTE: */ 
fdefine MPFROMCHAR(ch) ( (MPARAM) (USHORT) (ch)) 

/* Used to pass a SHORT, USHORT, or BOOL: */ 

#define MPFROMSHORT(s) ((MPARAM) (USHORT) (s)) 

/* Used to pass two SHORTs, USHORTs, or BOOLs: */ 
#define MPFROM2SHORT(sl, s2) ( ( MPARAM) MAKE LONG ( s 1 , s2)) 

/* Used to pass a SHORT and 2 UCHARs: (WM CHAR msg)*/ 
#define MPFR0MSH2CH(s, uchl, uch2) 

( (MPARAM)MAKELONG ( s , MAKESKORT(uchl, uch2) ) ) 

/* Used to pass a LONG or ULONG: */ 

#define MPFR0ML0NG(1 ) ((MPARAM) (ULONG) (1 ) ) 


Macros for extracting data from a MPARAM variable: 


/* Used to get any pointer type: */ 

#define PVOIDFROMMP(mp) ((VOID FAR *)(mp)) 

/* Used to get a window handle: */ 

^define HWNDFROMMP(mp) ((HWND)(mp)) 
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/* Used to get CHAR, UCHAR, or BYTE: 


fdefine CHARI FROMMP(mp) 
#define CHAR2FR0MMP(mp) 
fdefine CHAR3FR0MMP(mp) 
#define CHAR4FR0MMP(tnp) 


*/ 

((UCHAR) (mp)) 

( (UCHAR) ((ULONG)mp » 8)) 

( (UCHAR) ((ULONG)mp » 16)) 
( (UCHAR) ((ULONG)mp » 24)) 


/* Used to get a SHORT, USHORT, or BOOL: */ 

#define SHORTlFROMMP(mp) ( (USHORT) (ULONG)(mp)) 

fdefine SH0RT2FR0MMP(mp) ((USHORT) ((ULONG)mp » 16)) 


/* Used to get a LONG or ULONG: */ 

#def i ne LONGFROMMP(mp) ((ULONG) (mp)) 


Macros for packing data into a MRESULT variable: 


lie Used to pass any pointer type: */ 

fdefine MRFROMP(p) ((MRESULT) (VOID FAR *)(p)) 

/* Used to pass a SHORT, USHORT, or BOOL: */ 
fdefine MRFROMSHORT(s) ((MRESULT) (USHORT) (s)) 

/* Used to pass two SHORTs, USHORTs, or BOOLs: */ 
fdefine MRFR0M2SH0RT(sl, s2) ( (MRESULT) MAKELONG (si, s2)) 

/* Used to pass a LONG or ULONG: */ 

fdefine MRFROMLONG(l) ((MRESULT) (ULONG) (1)) 


Macros for extracting data from a MRESULT variable: 


/* Used to get any pointer type: */ 
fdefine PVOIDFROMMR(mr) ((VOID FAR *)(mr)) 

/it Used to get a SHORT, USHORT, or BOOL: it/ 
fdefine SHORTlFROMMR(mr) ((USHORT) ((ULONG)mr)) 

fdefine SK0RT2FR0MMR (mr) ((USHORT) ((ULONG)mr » 16)) 


/* Used to get a LONG or ULONG: */ 
fdefine LONGFROMMR(mr) ((ULONG) (mr)) 


The following macros are for use with DDESTRUCT and DDEINIT structures: 


/it Used to return a PSZ pointing to the ODE item name: */ 
fdefine DDES_PSZ ITEMNAME ( pddes ) \ 

(((PSZ)pddes) + ( (PODESTRUCT) pddes) ->offszItemName) 

/it Used to return a PBYTE pointing to the DDE data: */ 
fdefine DDES_PABDATA{ pddes) \ 

( ( (PBYTE)pddes) + ((PDDESTRUCT)pddes)->offabData) 

/* Used to convert a selector to a PDDESTRUCT: */ 

fdefine SELTOPDDES(sel ) ((PDDESTRUCT)MAKEP(sel , 0)) 

/* Used to PDDESTRUCT to a selector for freeing / reallocating: */ 
fdefine PDDESTOSEL(pddes) ( SELECTOROF (pddes ) ) 

/* Used to PDDEINIT to a selector for freeing: */ 
fdefine PDDEITOSEL(pddei) (SELECTOROF(pddei) ) 
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The following macros are for common operations on control windows: 

/★Used to set the check state of a button */ 

#define WinCheckButton(hwndDlg, id, usCheckState) \ 

((USHORT)WinSendDlgltemMsg (hwndDl g, id, BM_SETCHECK, \ 
MPFROMSHORT(usCheckState) , (MPARAM)NULL) ) 

/★Used to query the check state of a button */ 

#define WinQueryButtonCheckstate(hwndDlg, id) \ 

( ( USHORT ) Wi nSendOl g I temMsg { hwndDl g , id, BM_QUERYCHECK, \ 

MPARAM(NULL) , (MPARAM)NULL) ) 

/★Used to enable/disable a control in a dialog */ 

#define WinEnableControl {hwndDl g, id, fEnable) \ 

WinEnableWindow(WinWindowFromID (hwndDl g, id), fEnable) 

/★Used to check the enabled state of a control in a dialog */ 
fdefine WinlsControl Enabled (hwndDl g, id) \ 

( (BOOL)Wi nl sWi ndowEnabl ed (Wi nWi ndowFromID(hwndDl g , id))) 

/★Used to delete a listbox item */ 

#define WinDeleteLboxItem(hwndLbox, index) \ 

((SHORT)WinSendMsg(hwndLbox, LM_DELETEITEM, MPFROMSHORT ( i ndex) , \ 
(MAPRAM)NULL)) 

/★Used to insert an item into a listbox */ 

#define WinInsertLboxItem(hwndLbox, index, psz) \ 

(( SHORT) Wi nSendMsg ( hwnd Lboc , LM_INSERTITEM, MPFROMSHORT ( i ndex) , \ 
MPFROMP(psz))) 

/★Used to query the number of items in a listbox */ 

#define WinQueryLboxCount(hwndLbox) \ 

( (SHORT) Wi nSendMsg (hwndLbox, LMQUERY ITEMCOUNT , (MPARAM)NULL, \ 
(MPARAM)NULL) ) 

/★Used to query the text of a listbox item */ 

#define WinQueryLboxItemText(hwndlbox, index, psz, cchMax) \ 

((SHORT)Wi nSendMsg (hwndLbox, LM_QUERYITEMTEXT, \ 

MPFR0M2SK0RT ((index) , (cchMax)), MPFROMP(psz))) 

/★Used to query the text length of a listbox item */ 

#define WinQueryLboxItemTextLength (hwndLbox, index) \ 

(( SHORT) Wi nSendMsg ( hwnd Lbox , LM_QU E RYITEMTEXTLENGTH, \ 

MPFROMSHORT ( i ndex) , (MPARAM)NULL) ) 

/★Used to set the text of a listbox item */ 

(/define WinSetLboxItemText (hwndLbox, index, psz) \ 

( ( BOOL) Wi nSendMsg ( hwnd Lbox , LM_SETITEMTEXT, \ 

MPFROMSHORT ( i ndex) , MPFROMP(psz))) 

/★Used to query text of the selected listbox item */ 

/★(Single selection listboxes only) ★/ 

#define WinQueryLboxSelectedltem(handLbox) \ 

( ( SHORT ) Wi nSendMsg ( hwnd Lbox , LM_QUERYSELECTION, MPFROMSHORT(LIT_FIRST) , \ 
(MPARAM)NULL)) 
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Addressing Elements in Arrays 

Constants defining array elements are given values that are zero-based in C; that is, the numbering 
of the array elements starts at zero, not one. 

For example, in the DevQueryCaps function, the sixth element of the Array parameter is 
CAPS_HEIGHT, which is equated to 5. 

Count parameters related to such arrays always mean the actual number of elements available. 
Therefore, again using the DevQueryCaps function as an example, if all elements up to and including 
CAPS_HEIGHT are provided for, Count could be set to (CAPS_HEIGHT +1). 

In functions for which the starting array element can be specified, this is always zero-based, and so 
the C element number constants can be used directly. For example, to start with the CAPS_HEIGHT 
element, the Start parameter can be set to CAPSJHEIGHT. 


Implicit Pointer Data Types 

In this binding, a data type name beginning with “P” (for example, PERRORCODE) is likely to be a 
pointer to another data type (in this instance, ERRORCODE). 

In the following data type summary no explicit “typedefs” are shown for pointers. 

Therefore, if no data type definition can be found in the summary for a data type name “Pxxxxxx," it 
becomes a pointer to the data type “xxxxxx,” for which a definition should be found in the summary. 

The implicit type definition needed for such a pointer “Pxxxxxx” is: 
typedef xxxxxx FAR *Pxxxxxx; 

Such definitions are provided by means of the system header file OS2.H. 


Storage Mapping of Data Types 

The storage mapping of the data types is dependant on the machine architecture. In order to be port- 
able, applications must access the data types using the definitions supplied for that environment. 


Mapping Metalanguage Data Types to C Data Types 

Some data types shown in Chapter 2 of this book do not occur in C, but belong to the metalanguage 
data types described in Chapter 2 of the Presentation Manager Programming Reference. They are 
included to provide a mapping to the corresponding C data types, and can be identified as those that 
contain the phrase “(Maps via...).” 

This treatment is not needed for every metalanguage data type, as many of them have the same 
name as the corresponding C data type. 
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Chapter 2. 

ACCEL 

ACCELTABLE 

ARCPARAM 

ARCPARAMS 

AREABUNDLE 


ATOM 

BANDRECT 


Data Types 

Accelerator structure, 
typedef struct _ACCEL { 

USHORT fs; /* Options */ 

USHORT key; /* Key */ 

USHORT cmd; /* Command code */ 

} ACCEL; 

Accelerator-table structure, 
typedef struct _ACCELTABLE { 

USHORT cAccel; /* Number of accelerator entries */ 

USHORT codepage; /* Code page for accelerator entries */ 

ACCEL aaccel[l]; /* Accelerator entries */ 

} ACCELTABLE; 

Arc-parameters structure. 

(Maps via ARCPARAMS) 

Arc-parameters structure, 
typedef struct _ARCP ARAMS { 


LONG 

IP; 

/* 

P coefficient */ 

LONG 

IQ; 

/* 

Q coefficient */ 

LONG 

1R; 

/* 

R coefficient */ 

LONG 

IS; 

/* 

S coefficient */ 


} ARCPARAMS; 

Area-attributes bundle structure, 
typedef struct ^AREABUNDLE { 


LONG 

1 Col or; 

/* 

Area foreground color */ 

LONG 

IBackColor; 

/* 

Area background color */ 

USHORT 

usMixMode; 

/* 

Area f o reground -mi x mode */ 

USHORT 

usBackMixMode; 

/* 

Area background-mix mode */ 

USHORT 

usSet; 

/* 

Pattern set */ 

USHORT 

us Symbol ; 

/* 

Pattern symbol */ 

POINTL 

ptl Ref Point; 

/* 

Pattern reference point */ 


} AREABUNDLE; 

Atom identity, 
typedef USHORT ATOM; 

Rectangle structure, used for the coordinates of an output band (see 
DevEscape). 

An empty rectangle is one for which xleft is greater than xrlght, or ybottom 
is greater than ytop. 
typedef struct _BANDRECT { 


LONG 

IxLeft; 

/* 

x coordinate of left edge of rectangle */ 

LONG 

ly Bottom; 

/* 

y coordinate of bottom edge of rectangle 




*/ 

LONG 

lxRight; 

/* 

x coordinate of right edge of rectangle 




*/ 

LONG 

lyTop; 

/* 

y coordinate of top edge of rectangle */ 


} BANDRECT; 
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BITMAPINFO 


Bit-map information structure. 


Each bit plane logically contains (bitmapwidth*bitmapheight*bitcount) 
bits, although the actual length can be greater because of padding, 
typedef struct .BITMAPINFO { 


ULONG 

cbFix; 

/* 

Length of fixed portion of structure 
it/ 

USHORT 

cx; 

/* 

Bit-map width in pels */ 

USHORT 

cy; 

/* 

Bit-map height in pels */ 

USHORT 

cPlanes; 

/* 

Number of bit planes */ 

USHORT 

cBitCount; 

/* 

Number of bits per pel within a 
plane */ 

RGB 

argbColor[l] ; 

/* 

Array of RGB values */ 


} BITMAPINFO; 

BITMAPINFOHEADER Bit-map information header structure. 

Each bit plane logically contains (bitmapwidth*bitmaphelght*bitcount) 
bits, although the actual length can be greater because of padding, 
typedef struct .BITMAPINFOHEADER { 


ULONG 

cbFix; 

lit 

Length of structure */ 

USHORT 

cx; 

/* 

Bit-map width in pels */ 

USHORT 

cy; 

/* 

Bit-map height in pels */ 

USHORT 

cPlanes; 

/* 

Number of bit planes is/ 

USHORT 

cBitCount; 

/* 

Number of bits per pel within a plane 


*/ 

} BITMAPINFOHEADER; 


BIT8 Defines eight independent BOOL values. 

(Maps via UCHAR) 

BIT16 Defines 16 independent BOOL values. 

(Maps via USHORT) 

BIT32 Defines 32 independent BOOL values. 

(Maps via ULONQ) 

BOOL Boolean. 

The BOOL data type is defined such that a nonzero value indicates TRUE, 
and a zero value indicates FALSE. 

The constants TRUE and FALSE have been defined as 1 and 0 respec- 
tively. The constant TRUE should never be used in an equality comparison 
with a BOOL as this may result in incorrect results. 

When an application needs to pass a TRUE value on a function call, or as a 
return value from a window procedure, it is recommended that it passes 
the value TRUE, which is 1, and not a nonzero value. 

typedef unsigned short BOOL; 

BTNCDATA Button-control data structure. 

typedef struct .BTNCDATA { 

USHORT cb; /* Length of the control data in 

bytes */ 

USHORT fsCheckState; /* Check state of button */ 

USHORT fsHili teState; /is Highlighting state of button is/ 

} BTNCDATA; 

BUFFER Buffer. 

(Maps via PBYTE) 
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BUNDLE 

BYTE 

CATCHBUF 

CHAR 

CHARBUNDLE 


CLASSINFO 

COUNT2 

COUNT2B 

COUNT2CH 

COUNT4 

COUNT4B 

CFID 

CREATEPARAMS 


Bundle data area. It Is overlaid by one of these attribute bundle 
structures: 

AREABUNDLE 
CHARBUNDLE 
IMAGEBUNDLE 
LINEBUNDLE 
MARKERBUNDLE . 

(Maps via PBUNDLE) 

Byte. 

typedef unsigned char BYTE; 

Saved execution environment buffer, 
typedef struct _CATCHBUF { 

ULONG reserved [4]; /* Save area */ 

} CATCHBUF; 

Single-byte character. 

#define CHAR char 

Character-attributes bundle structure, 
typedef struct _CHARBUNDLE { 


LONG 

IColor; 

/* 

Character foreground color */ 

LONG 

IBackColor; 

/* 

Character background color */ 

USHORT 

usMixMode; 

/* 

Character foreground -mix mode */ 

USHORT 

usBackMixMode; 

/* 

Character background-mix mode */ 

USHORT 

usSet; 

/* 

Character set */ 

USHORT 

usPrecision; 

/* 

Character precision */ 

SIZEF 

sizfxCell ; 

/* 

Character cell size */ 

POINTL 

ptlAngle; 

/* 

Character angle if/ 

POINTL 

ptl Shear; 

/* 

Character shear */ 

USHORT 

usDi recti on; 

/* 

Character direction if/ 


} CHARBUNDLE; 

Class-information structure, 
typedef struct _CLA$SINF0 { 

ULONG flClassStyle; /* Class-style flags */ 

PFNWP pfnWindowProc; /* Window procedure */ 

USHORT cbWindowData; /* Number of additional window words 

*/ 

} CLASSINFO; 

Count in the range 0 through 65 535. 

(Maps via USHORT) 

Count of bytes, in the range 0 through 65 535. 

(Maps via USHORT) 

Count of characters, in the range 0 through 65 535. 

(Maps via USHORT) 

Count in the range 0 through 4 294 967 295. 

(Maps via ULONG) 

Count of bytes, in the range 0 through 4 294 967 295. 

(Maps via ULONG) 

Code-page identity. 

(Maps via USHORT) 

Create parameters structure. 

(Maps via STORAGE) 
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CREATESTRUCT 


CTLDATA 


CURSORINFO 


DDEINIT 


DDESTRUCT 


DEVOPENDATA 


Create-window data structure, 
typedef struct _CREATESTRUCT { 


PVOID 

pPresParams; 

/* 

PVOID 

pCtlData; 

/* 

USHORT 

id; 

/* 

HWND 

hwndlnsertBehind; 

/* 

HWND 

hwndOwner; 

lie 

SHORT 

cy; 

lie 

SHORT 

cx; 

lie 

SHORT 

y; 

lie 

SHORT 

x; 

lie 

UL0N6 

fl Style; 

lie 

PSZ 

pszText; 

lie 

PSZ 

pszClass; 

lie 

HWND 

hwndParent; 

lie 


} CREATESTRUCT; 


Presentation parameters */ 
Control data */ 

Window identifier */ 

Window behind which the window 
is to be placed */ 

Window owner */ 

Window height */ 

Window width */ 
y coordinate of origin */ 
x coordinate of origin */ 

Window style */ 

Window text */ 

Registered window class name */ 
Parent window handle */ 


Class-specific control data, beginning with a value conforming to a 
COUNT2B data type, which specifies the overall length of the data. 


The following are cases of this data type: 


BTNCDATA 

ENTRYFDATA 

FRAMECDATA 

SBCDATA 

MLECDATA 


Button control data. 

Entry field control data. 

Frame control data. 

Scroll bar control data. 

Multi-line entry field control data. 


(Maps via PVOID) 


Cursor-information structure, 
typedef struct _CURS0RINF0 { 


HWND 

hwnd; 

lie 

Window handle */ 

SHORT 

x; 

lie 

x coordinate */ 

SHORT 

y; 

lie 

y coordinate */ 

SHORT 

cx; 

lie 

Cursor width */ 

SHORT 

cy; 

lie 

Cursor height */ 

USHORT 

fs; 

lie 

Options */ 

RECTL 

rclClip; 

lie 

Cursor box */ 


} CURSORINFO; 


Dynamic data exchange initiation structure, 
typedef struct _DDEINIT { 

USHORT cb; /* Length of structure */ 

PSZ pszAppName; /* Application name */ 

PSZ pszTopic; /* Topic */ 

} DDEINIT; 

Dynamic data exchange control structure, 
typedef struct _DDESTRUCT { 


ULONG 

cbData; 

lie 

Total length */ 

USHORT 

fsStatus; 

lie 

Status */ 

USHORT 

usFormat; 

lie 

Data format */ 

USHORT 

offszItemName; 

lie 

Offset to item */ 

USHORT 

of f abData ; 

lie 

Offset to beginning of data */ 


} DDESTRUCT; 

Open-device data area. The format of this area is the same as a 
DEVOPENSTRUC structure. 

(Maps via PDEVOPENDATA) 
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DEVOPENSTRUC 


DLGTEM PLATE 


DLGTITEM 


Open-device data structure. 

The same structure is applicable to both DevOpenDC and SpIQmOpen 
calls. 

typedef struct _DEVOPENSTRUC { 


PSZ 

pszLogAddress; 

/if Logical address */ 

PSZ 

pszDri verName; 

/* Driver name */ 

PDRIVDATA 

pdriv; 


/* Driver data */ 

PSZ 

pszDataType; 


/if Data type iff 

PSZ 

pszComment; 


/if Comment */ 

PSZ 

pszQueueProcName; 

/if Queue-processor name */ 

PSZ 

pszQueueProcParams ; /* Queue-processor 




parameters */ 

PSZ 

pszSpool erParams ; 

/if Spooler parameters */ 

PSZ 

pszNetworkParams ; 

/if Network parameters */ 

} DEVOPENSTRUC; 



Dialog-template structure. 



typedef struct _DLGTEMPLATE { 


USHORT 

cbTemplate; 


/if Length of template */ 

USHORT 

type; 


/if Template format type */ 

USHORT 

codepage; 


/if Code page */ 

USHORT 

offadlgti ; 


/if Offset to dialog items */ 

USHORT 

fsTemplateStatus; 

/if Template status */ 

USHORT 

iltemFocus; 


/a Index of item to receive 




focus initially */ 

USHORT 

coffPresParams; 

/it Count of 




presentation-parameter offsets 
*/ 

DLGTITEM 

adlgti [1] ; 


/it Start of dialog items */ 

} DLGTEMPLATE; 



Dialog-item structure, 
typedef struct ^DLGTITEM { 



USHORT 

fsItemStatus; 

/* 

Status it/ 

USHORT 

cChildren; 

/* 

Count of children to this dialog 
item */ 

USHORT 

cchClassName; 

/* 

Length of class name */ 

USHORT 

offClassName; 

/* 

Offset to class name */ 

USHORT 

cchText; 

/* 

Length of text it/ 

USHORT 

offText; 

/* 

Offset to text */ 

ULONG 

fl Style; 

/* 

Dialog item window style */ 

SHORT 

x; 

/* 

x coordinate of origin of 
dialog- item window */ 

SHORT 

y; 

lie 

y coordinate of origin of 
dialog- item window */ 

SHORT 

cx; 

/* 

Dialog-item window width it/ 

SHORT 

cy; 

/* 

Dialog-item window height */ 

USHORT 

id; 

/* 

Identity */ 

USHORT 

offPresParams; 

/* 

Reserved it/ 

USHORT 

offCtlData; 

lie 

Offset to control data it/ 


} DLGTITEM; 
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DRIVDATA 

ENTRYFDATA 

ERRINFO 


ERRORID 

FATTRS 


FFDESCS 

FIXED 


Driver-data structure, 
typedef struct _DRIVDATA { 


LONG 

cb; 

/* 

Length */ 

LONG 

1 Vers ion; 

/* 

Version */ 

CHAR 

$zDeviceName[32] ; 

/* 

Device name */ 

CHAR 

abGeneralData[l] ; 

/* 

General data */ 


} DRIVDATA; 

Entry field control data structure, 
typedef struct JNTRYFDATA { 


USHORT 

cb; 

/* 

Length of control data in bytes 
ie! 

USHORT 

cchEditLimit; 

/* 

Edit limit */ 

USHORT 

ichMinSel ; 

/* 

Minimum selection */ 

USHORT 

ichMaxSel ; 

/* 

Maximum selection */ 

} ENTRYFDATA; 



Error-information structure. 



typedef struct ^ERRINFO { 



USHORT 

cbFixedErrlnfo; 

/* 

Length of fixed data to this 
structure */ 

ERRORID 

idError; 

/* 

Error identity */ 

USHORT 

cDetail Level ; 

/* 

Number of levels of detail */ 

USHORT 

offaoffszMsg; 

/* 

Offset to the array of message 
offsets */ 

USHORT 
} ERRINFO; 

offBinaryData; 

/* 

Offset to the binary data */ 

Error identity. 




typedef ULONG ERRORID; 


Font-attributes structure, 
typedef struct _FATTRS { 


USHORT 

usRecordLength; 

/* 

Length of record */ 

USHORT 

fsSelection; 

/* 

Selection indicators */ 

LONG 

IMatch; 

/* 

Matched-font identity */ 

CHAR 

szFacename [FACESIZE] ; 

/* 

Typeface name */ 

USHORT 

idRegistry; 

lie 

Registry identifier */ 

USHORT 

usCodePage; 

lie 

Code page */ 

LONG 

IMaxBaselineExt; 

lie 

Maximum base-line 
extension */ 

LONG 

lAveCharWidth; 

lie 

Average character width 
*/ 

USHORT 

fsType; 

lie 

Type indicators */ 

USHORT 
} FATTRS; 

fsFontUse; 

lie 

Font-use indicators */ 


Font-file descriptor, 
typedef CHAR FFDESCS [2] [FACESIZE] ; 

Signed-integer fraction (16:16). This can be treated as a LONG where the 
value has been multiplied by 65 536. 

typedef LONG FIXED; 
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FONTMETRICS 


Font-metrics structure, 
typedef struct .FONTMETRICS { 


CHAR szFamilyname[FACESIZE] ; 

CHAR szFacename[FACE$IZE] ; 

USHORT idRegistry; 

USHORT usCodePage; 

LONG lEmHeight; 

LONG lXHeight; 

LONG IMaxAscender; 

LONG IMaxDescender; 

LONG 1 LowerCaseAscent ; 

LONG 1 LowerCaseDescent ; 

LONG 1 Internal Leading; 

LONG 1 External Leadi ng ; 

LONG lAveCharWidth; 

LONG IMaxCharInc; 

LONG lEmlnc; 

LONG 1 MaxBas el i neExt ; 

SHORT sCharSlope; 

SHORT slnlineDir; 

SHORT sCharRot; 

USHORT usWeightClass; 

USHORT usWidthClass; 

SHORT sXDeviceRes; 

SHORT sYDeviceRes; 

SHORT sFirstChar; 

SHORT sLastChar; 

SHORT sOefaultChar; 

SHORT sBreakChar; 

SHORT sNomi nal Poi ntSi ze ; 

SHORT sMi nimumPoi ntSi ze ; 

SHORT sMaximumPoi ntSi ze ; 

USHORT fsType; 

USHORT fsDefn; 

USHORT fsSelection; 

USHORT f sCapabi 1 i ti es ; 

LONG 1 Subscri ptXSi ze; 

LONG 1 Subscri ptYSize; 

LONG 1 Subscri ptXOf f set ; 

LONG 1 Subscri ptYOf f set ; 

LONG 1 Superscri ptXSi ze ; 

LONG 1 Superscri ptYSi ze ; 

LONG 1 Superscri ptXOf f set ; 

LONG 1 Superscri ptYOf f set ; 

LONG 1 UnderscoreSi ze ; 

LONG 1 UnderscorePosi ti on ; 

LONG IStrikeoutSize; 

LONG 1 Stri keoutPosi ti on ; 

SHORT sKerningPairs; 

SHORT sFamilyClass; 

LONG 1 Match; 

} FONTMETRICS; 


/* Family name */ 

/* Facename */ 

/* Registry identifier */ 

/* Code page */ 

/* Em height */ 

/* x height */ 

/* Maximum ascender */ 

/* Maximum descender */ 

/* Lowercase ascent */ 

/it Lowercase descent */ 

/it Internal leading it/ 

/it External leading */ 

/* Average character width 
*/ 

/ir Maximum character 
increment */ 

/it Em increment */ 

/it Maximum baseline extent 
it/ 

/it Character slope */ 

/it Inline direction */ 

/* Character rotation it/ 

/* Weight class */ 

/* Width class */ 

/it x device resolution */ 
/it y device resolution */ 
/it First character it/ 

/it Last character */ 

/it Default character it/ 

/it Break character */ 

/* Nominal point size it/ 

/it Minimum point size */ 

/it Maximum point size it/ 

/it Type indicators */ 

/it Definition indicators it/ 
/it Selection indicators */ 
/it Capabilities it/ 

/it Subscript x size */ 

/* Subscript y size */ 

/it Subscript x offset it/ 

/it Subscript y offset */ 

/* Superscript x size */ 

/* Superscript y size */ 

/it Superscript x offset it/ 
/it Superscript y offset */ 
/it Underscore size */ 

/it Underscore position it/ 
/it Strikeout size */ 

/it Strikeout position */ 

/* Kerning pairs it/ 

/it Family class it/ 

/it Matched font identity */ 
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FRAMECDATA 

GRADIENT 

GRADIENT!. 

HAB 

HACCEL 

HANDLE 

HAPP 

HATOMTBL 

HBITMAP 

HCINFO 


HDC 


Frame-control data structure, 
typedef struct ^FRAMECDATA { 


USHORT 

cb; 

/* 

Length */ 

ULONG 

flCreateFl ags; 

/* 

Frame-creation flags */ 

HMODULE 

hmodResources; 

/* 

Identifier of required resource 

*/ 

USHORT i dResources ; 

} FRAMECDATA; 

lie 

Resource identifier */ 


Direction-vector structure. 

(Maps via GRADIENTL) 

Direction-vector structure, 
typedef struct _GRADIENTL { 

LONG x; /* x component of direction */ 

LONG y; /* y component of direction */ 

} GRADIENTL; 

Anchor-block handle. 

typedef LHANDLE HAB; 

Accelerator-table handle. 

typedef LHANDLE HACCEL; 

Resource handle. 

(Maps via LHANDLE) 

Handle of an application started by the WinlnstStartApp function, 
typedef LHANDLE HAPP; 

Atom-table handle, 
typedef LHANDLE HATOMTBL; 

Bit-map handle, 
typedef LHANDLE HBITMAP; 

Hardcopy-capabilities structure, 
typedef struct _HCINF0 { 


CHAR 

$zFormname[32]; 

lie 

Form name */ 

LONG 

cx; 

lie 

Width (left-to-right) in 
millimeters */ 

LONG 

cy; 

lie 

Height (top-to-bottom) in 
millimeters */ 

LONG 

xLeftClip; 

lie 

Left clip limit in millimeters */ 

LONG 

yBottomClip; 

lie 

Bottom clip limit in millimeters */ 

LONG 

xRightClip; 

lie 

Right clip limit in millimeters */ 

LONG 

yTopClip; 

lie 

Top clip limit in millimeters */ 

LONG 

xPels; 

lie 

Number of pels between left and 
right clip limits */ 

LONG 

yPels; 

lie 

Number of pels between bottom and 
top clip limits */ 

LONG 

fl Attributes; 

lie 

Attributes of the form identifier 

iel 


} HCINFO; 


Device-context handle, 
typedef LHANDLE HDC; 
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HELPINIT 


HELPSUBTABLE 


Help manager initialization structure. 



typedef struct 
USHORT 

_HELPINIT { 
cb; 

/* 

Count of bytes of 

ULONG 

ul ReturnCode; 

/* 

the initialization 
structure */ 

Value returned by 

PSZ 

pszTutorialName; 

/* 

the Help Manager from 
initialization */ 
Indicates to the 

PHELPTABLE 

phtHel pTable; 

/* 

Help Manager that the 
application has a 
tutorial program */ 
Help table */ 

HMODULE 

hmodHel pTabl eModul e ; 

/* 

Resource file 

HMODULE 

hmodAccel Acti onBarModul e; 

/* 

identity */ 

Handle of the DLL 

USHORT 

idAccel Table; 

/* 

that contains the 
accelerator table and 
action bar template 
to be used by the 

Help Manager */ 
Identity of the 

USHORT 

idActionBar; 

/* 

accelerator table */ 
Identity of the 


action bar template 
used by the Help 
Manager */ 


PSZ 

pszHelpWindowTitle; 

/* 

Window title for 
each help window */ 

USHORT 

usShowPanelld; 

/* 

Show panel identity 
indicator */ 

PSZ 

pszHelpLibraryName; 

/* 

Names of the help 
panel libraries that 
the Help Manager 
searches on each help 
request */ 

} HELPINIT; 




Help subtable structure. 



typedef struct 

_HELPSUBTABLE { 



USHORT 

usSubitemSize; 


/it Number of 


words in 
each entry 
of the help 
subtabl e 
*/ 

HELPSKBTABLEITEM ahstiHelpSubTabl el terns [1] ; /* Array of 

help 

subtable 
entries */ 

} HELPSUBTABLE; 
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HELPSUBTABLEITEM 


HELPTABLE 


HENUM 

HHEAP 

HINI 

HUB 

HMF 

HMODULE 

HMQ 

HPOINTER 

HPROC 


Help subtable entry structure, 
typedef struct .HELPSUBTABLEITEM { 

USHORT idField; /* Identity of the 

field from which the 
user can request help 
*/ 

USHORT idHelpPanel; /* Identity of the 

contextual help panel 

*/ 

USHORT ausOpti onal Integers [subitemsize-2] ; /* 

Application-related 
integers */ 

} HELPSUBTABLEITEM; 


Help table structure. 


This is an array of help table entries, each of which has the structure 
defined below, the last entry of the array having its extpanel parameter set 
to NULL. 


typedef struct .HELPTABLE { 

USHORT idAppWindow; 

PHELPSUBTABLE phstHel pSubTabl e ; 

USHORT idExt Panel; 

} HELPTABLE; 


/* Application window 
identity */ 

/* Help subtable for this 
application window */ 
/* Identity of the 

extended help panel for 
the application window 
*/ 


Window-enumeration handle. 


typedef LHANDLE HENUM; 
Heap handle, 
typedef LHANDLE HHEAP; 
Initialization-file handle. 


typedef LHANDLE HINI; 
Library handle, 
typedef LHANDLE HLIB; 
Metafile handle. 


typedef LHANDLE HMF; 
Module handle, 
typedef USHORT HMODULE; 
Message-queue handle, 
typedef LHANDLE HMQ; 
Handle of a pointer, 
typedef LHANDLE HPOINTER; 
Processor handle, 
typedef LHANDLE HPROC; 
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HPROGARRAY 

HPROGRAM 

HPS 

HRGN 

HSEM 

HSPL 

HSWITCH 

HVPS 

HWND 

IDENTITY 

IDENTITY4 

IMAGEBUNDLE 

INDEX2 

IPT 

KERNINGPAIRS 

LENGTH2 

LENGTH4 


Array of program handles, 
typedef struct .HPROGARRAY { 

HPROGRAM ahprog[l] ; /* Program handle array */ 

} HPROGARRAY; 

Program handle, 
typedef LHANDLE HPROGRAM; 

Presentation-space handle, 
typedef LHANDLE HPS; 

Region handle, 
typedef LHANDLE HRGN; 

Semaphore handle, 
typedef VOID FAR *HSEM; 

Spooler handle, 
typedef LHANDLE HSPL; 

Switch-list entry handle, 
typedef LHANDLE HSWITCH; 

VIO presentation-space handle, 
typedef USHORT HVPS; 

Window handle, 
typedef LHANDLE HWND; 

Identity value. Up to 65 536 different identities are available. 

(Maps via USHORT) 

Identity value. Up to 4 294 967 296. different identities are available. 
(Maps via ULONG) 

Image-attributes bundle structure, 
typedef struct .IMAGEBUNDLE { 


LONG 

1 Col or; 

/* 

Image 

foreground color */ 

LONG 

IBackColor; 

/* 

Image 

background color */ 

USHORT 

usMixMode; 

i* 

Image 

foreground-mix mode */ 

USHORT 

usBackMixMode; 

/* 

Image 

background-mix mode */ 


} IMAGEBUNDLE; 

Index value, in the range 0 through 65 535. 

(Maps via USHORT) 

Insertion point for multi-line entry field. 

typedef LONG IPT; 

Kerning-pair records structure, 
typedef struct .KERNINGPAIRS { 

SHORT sFirstChar; /* First character of pair */ 

SHORT sSecondChar; /* Second character of pair */ 

SHORT sKerningAmount; /* Amount of kerning for this pair 

*/ 

} KERNINGPAIRS; 

Length value, in the range 0 through 65 535. 

(Maps via USHORT) 

Length value, in the range 0 through 4 294 967 295. 

(Maps via ULONG) 
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LHANDLE 

LINEBUNDLE 


LONG 


MARGSTRUCT 

MARKERBUNDLE 


MATRIX 


The handle of a resource. 

typedef VOID FAR * LHANDLE; 

Line-attributes bundle structure, 
typedef struct _LINEBUNDLE { 


LONG 

1 Col or; 

/* 

Line foreground color */ 

LONG 

1 Reserved; 

/* 

Reserved */ 

USHORT 

usMixMode; 

/* 

Line foreground-mix mode */ 

USHORT 

usReserved; 

/* 

Reserved */ 

FIXED 

fxWidth; 

/* 

Line width */ 

LONG 

lGeomWidth; 

/* 

Geometric line width */ 

USHORT 

usType; 

/* 

Line type */ 

USHORT 

usEnd; 

/* 

Line end */ 

USHORT 

usJoin; 

/* 

Line join */ 


} LINEBUNDLE; 

Signed integer in the range -2 147 483 648 through 2 147 483 647. 

Note: Where this data type represents a graphic coordinate in world or 
model space, its value is restricted to -134 217 728 through 
134 217 727. A graphic coordinate in device or screen coordinates 
is restricted to -32 768 through 32 767. Its value may be further 
restricted by any transforms currently in force, including the posi- 
tioning of the origin of the window on the screen. In particular, 
coordinates in world or model space must not generate coordinate 
values after transformation (that is in device or screen space) 
outside the range -32 768 through 32 767. 

#define LONG long 

Multi-line entry field margin information 
typedef struct ^MARGSTRUCT { 

USHORT fsFlags; 

USHORT usMouMsg; 

IPT iptNear; 

} MARGSTRUCT; 

Marker-attributes bundle structure, 
typedef struct ^MARKERBUNDLE { 


LONG 

1 Col or; 

/* 

Marker foreground color */ 

LONG 

IBackColor; 

/* 

Marker background color */ 

USHORT 

usMixMode; 

/* 

Marker fo reground -mix mode */ 

USHORT 

usBackMixMode; 

/* 

Marker background-mix mode */ 

USHORT 

usSet; 

/* 

Marker set */ 

USHORT 

usSymbol ; 

/* 

Marker symbol */ 

SIZEF 

sizfxCell ; 

/* 

Marker cell */ 


} MARKERBUNDLE; 

Matrix-elements structure. 
(Maps via MATRIXLF) 
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MATRIXLF Matrix-elements structure. 


typedef 

struct _ 

MATRIXLF 

i 

FIXED 

fxMll; 

lie 

First element of first row */ 

FIXED 

fxM12; 

lie 

Second element of first row */ 

LONG 

1M13; 

lie 

Third element of first row if/ 

FIXED 

fxM21; 

tie 

First element of second row */ 

FIXED 

fxM22; 

lie 

Second element of second row */ 

LONG 

1M23; 

lie 

Third element of second row */ 

LONG 

1M31; 

/* 

First element of third row */ 

LONG 

1M32; 

lie 

Second element of third row */ 

LONG 

1M33; 

lie 

Third element of third row */ 


} MATRIXLF; 

MENUITEM Menu Item. 

typedef struct _MENUITEM { 


SHORT 

iPosition; /* 

Position */ 

USHORT 

af Style; /* 

Style */ 

USHORT 

afAttribute; /* 

Attribute */ 

USHORT 

id; lie 

Identity */ 

HWND 

hwndSubMenu; /* 

Submenu it/ 

ULONG 

hltem; /* 

Item id 

} MENUITEM; 



MLECTLDATA Multi-line entry field control data structure. 

typedef struct _MLECTLDATA { 


USHORT 

cbCtlData; 

/if Length of control data in bytes 
ie! 

USHORT 

aflEFormat; 

/* Import/export format */ 

ULONG 

cchText; 

lie Text limit */ 

IPT 

ipt Anchor; 

lie Selection anchor point */ 

IPT 

iptCursor; 

/ie Selection cursor point */ 

LONG 

cxFormat; 

/ie Formatting rectangle width in 
pixels ie/ 

LONG 

cy Format; 

/ie Formatting rectangle height in 
pixels ie/ 

ULONG 

afFormatFlags; 

lie Format flags */ 


} MLECTLDATA; 

M LE SE A RCH DAT A Search structure for multi-line entry field. 

typedef struct _MLE_SEARCHDATA { 


SHORT 

sStructSize; 

lie 

Size of MLEJEARCHDATA 
structure */ 

SHORT 

sFindStringLength; 

lie 

Length of findstring string 
ie! 

PSZ 

pszFindString; 

lie 

String to search for */ 

IPT 

iptStart; 

lie 

Point at which to start 
search, or point where string 
was found ie! 

IPT 

iptStop; 

lie 

Point at which to stop 
search */ 

SHORT 

sFoundStringLength; 

lie 

Length of string found at 
start */ 

SHORT 

sChangeSt ri ngLength ; 

lie 

Length of replacement string 
iel 

PSZ pszChangeString; 

} MLE_SEARCHDATA; 

lie 

Replacement string */ 


MT Menu template. 

(Maps via PVOID) 
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MTI 


M PAR AM 


MQINFO 


MRESULT 


NPBYTE 

OFFSET2B 

OVERFLOW 


Menu template item, 
typedef struct _MTI { 


USHORT 

afStyle; 

/* 

Style */ 

USHORT 

afAttrs ; 

/* 

Attributes */ 

USHORT 

idltem; 

/* 

Item identity */ 

CHAR 

c[2] ; 

/* 

Item data */ 


} MTI ; 

4-byte message-dependent parameter structure. 

Certain elements of information, placed into the parameters of a message, 

have data types that do not consume the whole of the 4 bytes of this data 

type. The ruies governing these cases are: 

BOOL The value is contained in the low word and the high word is 
zero. 

SHORT The value is contained in the low word and its sign is 
extended into the high word. 

USHORT The value is contained in the low word and the high word is 
zero. 

NULL The entire 4 bytes are zero, 
typedef VOID FAR *MPARAM; 

Message-queue information structure, 
typedef struct _MQINF0 { 


USHORT 

cb; 

/* 

Length of structure */ 

PID 

pi d; 

/* 

Process identity */ 

TID 

tid; 

/* 

Thread identity */ 

USHORT 

cmsgs ; 

/* 

Message count */ 

PVOID 

pReserved; 

/* 

Reserved */ 


} MQINFO; 

4-byte message-dependent reply parameter structure. 

Certain elements of information, placed into the parameters of a message, 
have data types that do not consume the whole of the 4 bytes of this data 
type. The rules governing these cases are: 

BOOL The value is contained in the low word and the high word is 
zero. 

SHORT The value is contained in the low word and its sign is 
extended into the high word. 

USHORT The value is contained in the low word and the high word is 
zero. 

NULL The entire 4 bytes are zero. 

typedef VOID FAR *MRESULT; 

Near pointer to a byte string. 

typedef BYTE near *NPBYTE; 

Offset value in bytes, in the range 0 through 65 535. 

(Maps via USHORT) 

Overflow error structure for multi-line entry field, 
typedef struct .OVERFLOW { 


ULONG 

ulErrlnd; 

/* 

One or more EFR_* flags */ 

LONG 

lBytesOver; 

/* 

Number of bytes over the limit */ 

PIX 

pixHorzOver; 

/* 

Number of pixels over the horizontal 




limit */ 

PIX 

pixVertOver; 

/* 

Number of pixels over the vertical 


limit */ 

} OVERFLOW; 
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OWNERITEM 


PARAM 

PBUNDLE 

PBYTE 

PCH 

PDEVOPENDATA 

PFFDESCS 

PFN 

PFNWP 

PIBSTRUCT 


Owner item. 

typedef struct _OWNERITEM { 


HWND 

hwnd; 

/* 

Window handle */ 

HPS 

hps; 

/* 

Presentation-space handle */ 

USHORT 

fsState; 

/* 

State id 

USHORT 

fsAttri bute; 

/* 

Attribute */ 

USHORT 

fsStateOld; 

/* 

Old state */ 

USHORT 

fsAttri buteOld; 

/* 

Old attribute */ 

RECTL 

rcl Item; 

/* 

Item rectangle */ 

SHORT 

idltem; 

/* 

Item identity */ 

ULONG 

hltem; 

/* 

Item */ 


} OWNERITEM; 

Presentation parameter attribute definition, 
typedef struct _PARAM { 

ULONG id; /* Attribute type identity */ 

ULONG cb; /* Byte count of the attrvalue parameter */ 

BYTE ab[l] ; /* Attribute value */ 

} PARAM; 

Points to a bundle data area, 
typedef PVOID PBUNDLE; 

Pointer to a data area, 
typedef BYTE FAR *PBYTE; 

Pointer to a character string, 
typedef char far *PCH; 

Open device-data array. 

This data type points to data whose format is described by the 
DEVOPENSTRUC data type. 

typedef PSZ FAR *PDEVOPENDATA; 

Pointer to a font file descriptor. 

typedef FFDESCS FAR *PFFDESCS; 

Pointer to procedure. 

typedef int (pascal far *PFN)(); 

Pointer to a window procedure. 

typedef MRESULT (PASCAL FAR *PFNWP) (HWND, USHORT, MPARAM, MPARAM) ; 

Program-information-block structure, 
typedef struct _PIBSTRUCT { 


PROGTYPE 

progt; 

/ie Program type and 
visibility */ 

CHAR 

SzT i tl e [MAXNAMEL+1] ; 

/* Program title 
(null terminated) 

*/ 

CHAR 

szIconFi 1 eName [MAXPATHL+1] ; 

tie Program icon 
filename (null 
terminated) */ 

CHAR 

szExecutabl e[MAXPATHL+l] ; 

/* Executabl e f i 1 e 
name (null 
terminated) ic/ 

CHAR 

szStartupDir [MAXPATHL+1] ; 

/ic Start-up 


directory (null 
terminated) */ 
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PID 

PIX 

PMPARAM 

PM RESULT 

POINT 

POINTERINFO 

POINTL 

POINTS 

PQMOPENDATA 


XYWINSIZE 

xywinlnitial ; 

/•k Initial window 
position and size 

*/ 

USHORT 

resl; 

/if Reserved; must 
be zero */ 

LHANDLE 

res2; 

/if Reserved; must 
be zero it/ 

USHORT 

cchEnvironmentVars; 

/it Environment 
string length */ 

PCH 

pchEnvi ronmentVars ; 

/it Environment 
string */ 

USHORT 

cchProgramParameter ; 

/it Parameter string 
length */ 

PCH 

pchProgramParameter; 

/it Parameter string 


*/ 

} PIBSTRUCT; 

Process identity, 
typedef USHORT PID; 

Pel count for multi-line entry field, 
typedef LONG PIX; 

Pointer to a 4-byte message-dependent parameter structure, 
typedef MPARAM FAR * PMPARAM; 

Pointer to a 4-byte message-dependent reply parameter structure. 

typedef MRESULT FAR *PMRESULT; 

Point structure. 

(Maps via POINTL) 

Pointer-information structure, 
typedef struct _P0INTERINF0 { 


BOOL 

f Pointer; 

/* 

Bit-map size indicator it/ 

SHORT 

xHotspot; 

/* 

x coordinate of action point */ 

SHORT 

y Hotspot; 

/* 

y coordinate of action point */ 

HBITMAP 

hbmPointer; 

/* 

Bit-map handle of pointer */ 

HBITMAP 

hbmColor; 

/* 

Bit-map handle of color bit map */ 


} POINTERINFO; 

Point structure (long integer), 
typedef struct _P0INTL { 

LONG x; /* x coordinate */ 

LONG y; /* y coordinate */ 

} POINTL; 

Point structure (short integer), 
typedef struct _P0INTS { 

SHORT x; /* x coordinate if/ 

SHORT y; /* y coordinate */ 

} POINTS; 

Open queue-manager data array. 

This data type points to data whose format is described by the 
DEVOPENSTRUC data type. 

typedef PSZ FAR *PQMOPENDATA; 
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PRESPAR AMS Presentation parameter data. 

typedef struct _PRESPARAMS { 

ULONG cb; /* Byte count of the parara parameter */ 

PARAM aparam[l] ; /* Array of attribute parameters */ 

} PRESPARAMS; 

PRESDATA Class-specific control presentation data, conforming to a PRESPARAM 

data type. 

(Maps via PVOID) 

PRFPROFILE Profile structure. 

typedef struct _PRFPROFILE { 


ULONG 

cchUserName; 

/* 

Length of user profile name iel 

PSZ 

pszUserName; 

/* 

User profile name iel 

ULONG 

cchSysName; 

/* 

Length of system profile name iel 

PSZ 

pszSysName; 

/* 

System profile name iel 


} PRFPROFILE; 

PROC Procedure identifier. 

(Maps via PFN) 

PROGCATEGORY Program category. 

typedef CHAR PROGCATEGORY; 

PROGDETAILS Program details structure. 

typedef struct ^PROGDETAILS { 
ULONG Length; 

PROGTYPE progt; 

USHORT padl[3] ; 

PSZ pszTitle; 

PSZ pszExecutable; 

PSZ pszParameters ; 

PSZ pszStartupDir; 

PSZ pszlcon; 

PSZ psz Environment; 


SWP swplnitial; 

USHORT pad2 [5] ; 

} PROGDETAILS; 

PROGRAMENTRY Program-entry structure. 

typedef struct ^PROGRAMENTRY { 

HPROGRAM hprog ; 

PROGTYPE progt; 

CHAR szTitle[MAXNAMEL+l]s 

} PROGRAMENTRY; 

PROGTITLE Program-title structure. 

typedef struct _PROGTITLE { 

HPROGRAM hprog; /* Program handle */ 

PROGTYPE progt; /* Program type */ 

USHORT padl [3] ; lie Reserved */ 

PSZ pszTitle; /* Program title */ 

} PROGTITLE; 


/* Program handle */ 
/ic Program type */ 
lie Program title (null 
terminated) */ 


/* Length of structure */ 
lie Program type */ 
lie Reserved iel 
lie Title iel 

lie Executable file name iel 
lie Parameter string iel 
lie Start-up directory */ 
lie Icon-file name iel 
lie Environment string. (List of 
null -terminated strings, ending 
with an extra null) iel 
lie Initial window position and 
size iel 

lie Reserved iel 
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PROGTYPE 


PROPERTY2 

PROPERTY4 

PSZ 

PVOID 


QMOPENDATA 

QMSG 


RECT 


RECTL 


RESID 

RGB 


Program-type structure, 
typedef struct ^PROGTYPE { 

PROGCATEGORY progc; /* Program category */ 

UCHAR fbVisible; /* Visibility attribute */ 

} PROGTYPE; 

Property value. Up to 65 536 different properties are available. 

(Maps via USHORT) 

Property value. Up to 4 294 967 296 different properties are available. 
(Maps via LONG) 

Pointer to a null-terminated string, 
typedef char far *PSZ; 

Pointer to a data type of undefined format, 
typedef VOID FAR *PV0ID; 

Open queue-manager data area. The format of this area is the same as a 
DEVOPENSTRUC structure. 

(Maps via PQMOPENDAT A) 

Message structure, 
typedef struct _QMSG { 


HWND 

hwnd; 

/* Window handle */ 

USHORT 

msg; 

/* Message identity */ 

MPARAM 

mpl; 

lie Parameter 1 iel 

MPARAM 

mp2; 

lie Parameter 2 iel 

ULONG 

time; 

lie Message time */ 

POINTL 

ptl; 

lie Pointer position when message was generated 



*/ 

} QMSG; 



Rectangle 

structure. 



Unless otherwise stated, points on the right-hand or top boundaries of the 
rectangle are not considered to be included in the rectangle; points on the 
left-hand or bottom boundaries (that are not also on the right-hand or top 
boundaries) are included in the rectangle. 

(Maps via RECTL) 

Rectangle structure, 
typedef struct _RECTL { 


LONG 

xLeft; 

/* 

x coordinate of left-hand edge of rectangle 
iel 

LONG 

yBottom; 

/* 

y coordinate of bottom edge of rectangle 
iel 

LONG 

xRight; 

/* 

x coordinate of right-hand edge of 
rectangle iel 

LONG 

yTop; 

/* 

y coordinate of top edge of rectangle iel 

} RECTL; 



Resource identity. 



(Maps via HMODULE) 


RGB color value. 



typedef struct _RGB { 


BYTE 

bBlue; 

I* 

Blue component of the color definition */ 

BYTE 

bGreen; 

I* 

Green component of the color definition */ 

BYTE 

bRed; 

lie 

Red component of the color definition */ 


} RGB; 
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RGNRECT 


ROF 

ROL 

SBCDATA 


SEGOFF 

SFACTORS 

SHORT 

SIZEF 

SIZEL 

SIZEROF 

SIZEROL 


Region-rectangle structure, 
typedef struct _RGNRECT { 


USHORT 

i restart; 

/* 

Rectangle number from which to start 
enumerating */ 

USHORT 

crc; 

/* 

Number of rectangles that can be 
returned */ 

USHORT 

crcReturned; 

/* 

Number of rectangles returned it/ 

USHORT 

usDi recti on; 

/* 

Direction in which the returned 
rectangles are to be ordered */ 


} RGNRECT; 

Number representation, equivalent to FIXED. 
(Maps via FIXED) 

Number representation, equivalent to LONG. 
(Maps via LONG) 

Scroll-bar control data structure, 
typedef struct _SBCDATA { 


USHORT 

cb; 

/* 

Length of control data in bytes */ 

USHORT 

sHilite; 

/* 

Highlighting code it/ 

SHORT 

posFirst; 

/is 

First bound of the scroll -bar range it/ 

SHORT 

posLast; 

/is 

Last bound of the scroll -bar range */ 

SHORT 

posThumb; 

/is 

Slider position */ 

SHORT 

cVisible; 

/is 

Number of data items visible it/ 

SHORT 

cTotal ; 

/is 

Number of data items available */ 


} SBCDATA; 

2-byte segment offset in bytes. 

(Maps via NPBYTE) 

Scaling factors, see DevEscape. 
typedef struct _SFACT0RS { 

LONG lx; /* x scaling factor, as an exponent of 2 */ 
LONG ly; /* y scaling factor, as an exponent of 2 */ 
} SFACTORS; 

Signed integer in the range -32 768 through 32 767. 

#define SHORT short 

Size structure, 
typedef struct _SIZEF { 

FIXED cx; /* Width */ 

FIXED cy; / * Height */ 

} SIZEF; 

Size structure, 
typedef struct _SIZEL { 

LONG cx; /* Width */ 

LONG cy; /* Height */ 

} SIZEL; 

Size structure. 

(Maps via SIZEF) 

Size structure. 

(Maps via SIZEL) 
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SMHSTRUCT 


STORAGE 

STR 

STRCOND 

STRL 

STRLLIST 

STR8 

STR16 

STR32 

STR64 

SWBLOCK 

SWCNTRL 


Send message hook structure, 
typedef struct _SMHSTRUCT { 


MPARAM 

mp2; 

/* 

Parameter 2 */ 

MPARAM 

mpl; 

/* 

Parameter 1 */ 

USHORT 

msg; 

/* 

Message identity */ 

HWND 

hwnd; 

/* 

Window handle */ 


> SMHSTRUCT; 

Storage that may contain different data types. 

(Maps via PVOID) 

String with an explicit length count. 

(Maps via PCH) 

String with a length count that is determined by certain values in its asso- 
ciated length parameter. 

For example, positive values in the associated length parameter provide 
the length count explicitly, whereas the value -1 implies that the string is 
null-terminated and hence its length is implicit. 

Where this data type occurs, the associated length parameter specifies the 
meanings of its values in determining the length count of the string. 

(Maps via PCH) 

Null-terminated string, that is, its length can be implied by the system. 
(Maps via SZ) 

A list of null-terminated strings (that is, a series of concatenated strings 
each of which has a STRL data type) terminated by an additional null. 
(Maps via SZ) 

String of 8 characters. 

typedef CHAR STR8[8]; 

String of characters, with an implicit length, in a 16-byte field, 
typedef CHAR STR16[16] ; 

String of characters, with an implicit length, in a 32-byte field, 
typedef CHAR STR32[32] ; 

String of characters, with an implicit length, in a 64-byte field. 

typedef CHAR STR64[64] ; 

Switch list block structure, 
typedef struct _SWBL0CK { 

USHORT cswentry; /* Count of switch list entries */ 

SWENTRY aswentryfl]; /* Switch list entries */ 

} SWBLOCK; 

Switch-list control block structure, 
typedef struct _SWCNTRL { 


HWND 

hwnd; 

/* Window handle */ 

HWND 

hwndlcon; 

/* Window-handle icon */ 

H PROG RAM 

hprog; 

/* Program handle */ 

USHORT 

idProcess; 

/* Process identity */ 

USHORT 

idSession; 

lie Session identity */ 

UCHAR 

uchVisibility; 

lie Visibility */ 

UCHAR 

fbJump; 

lie Jump indicator */ 

CHAR 

szSwtitle[MAXNAMEL+l] ; 

lie Switch-list control 



block title (null 



terminated) */ 

BYTE 

f Reserved; 

lie Reserved */ 


} SWCNTRL; 
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SWENTRY 

SWP 


SZ 

TID 

TIME 

TRACKINFO 


UCHAR 

ULONG 

USERBUTTON 

USHORT 


Switch list entry structure, 
typedef struct _SWENTRY { 

HSWITCH hswitch; /* Switch list entry handle */ 

SWCNTRL swctl; /* Switch list control block structure */ 

} SWENTRY; 

Set Window Position structure, 
typedef struct _SWP { 


USHORT 

fs; 

/* 

Options iel 

SHORT 

cy; 

/* 

Window height */ 

SHORT 

cx; 

lit 

Window width itl 

SHORT 

y; 

/* 

y coordinate of origin */ 

SHORT 

x ; 

/* 

x coordinate of origin */ 

HWND 

hwndlnsertBehind; 

lie 

Window behind which this 
window is placed */ 

HWND 
} SWP; 

hwnd; 

/* 

Window handle */ 


Null-terminated string (also known as a zero-terminated string). 
(Maps via PSZ) 


Thread identity. 

typedef USHORT TID; 

Time interval in milliseconds. 

(Maps via LONG) 

Tracking-information structure 
typedef struct _TRACKINFO { 

SHORT cxBorder; 

SHORT cy Border; 

SHORT cxGrid; 

SHORT cyGrid; 

SHORT cxKeyboard; 

SHORT cy Keyboard; 

RECTL rcl Track; 

RECTL rcl Boundary; 

POINTL ptlMi nTrackSize; 

POINTL ptlMaxTrackSize; 

USHORT fs; 

} TRACKINFO; 

Unsigned integer in the range 0 through 255. 

typedef unsigned char UCHAR; 

Unsigned integer in the range 0 through 4 294 967 295. 
typedef unsigned long ULONG; 

User-button data structure. 


typedef struct ^USERBUTTON { 


HWND 

hwnd; 

/* 

Window handle */ 

HPS 

hps; 

/* 

Presentation-space handle */ 

USHORT 

fsState; 

/* 

New state of user button */ 

USHORT 

fsStateOld; 

/* 

Old state of user button */ 


> USERBUTTON; 

Unsigned integer in the range 0 through 65 535. 
typedef unsigned short USHORT; 


/* Border width */ 

/* Border height */ 

/* Grid width */ 

/* Grid height */ 

/* Character cell width movement 
for arrow key */ 

/* Character cell height movement 
for arrow key */ 

/ic Starting tracking rectangle it/ 
/it Boundary rectangle it/ 

/it Minimum tracking size */ 

lit Maximum tracking size */ 

/it Tracking options */ 
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VIOSIZECOUNT 


VIOFONTCELLSIZE 

VOID 

WIDTH4 

WNDPARAMS 


WNDPROC 

WPOINT 

WRECT 


Count of VIO cell sizes, see DevEscape. 
typedef struct .VIOSIZECOUNT { 


LONG 

maxcount ; 

/* 

Maximum number of VIO cell sizes 
supported */ 

LONG 

count; 

/* 

Number of VIO cell sizes returned */ 


} VIOSIZECOUNT; 

VIO cell size, see DevEscape. 
typedef struct .VIOFONTCELLSIZE { 

LONG cx; /* Cell width */ 

LONG cy; /* Cell height */ 

} VIOFONTCELLSIZE; 

A data area of undefined format. 

#define VOID void 

Width in the range -2 147 483 648 through 2 147 483 647. 
(Maps via LONG) 

Window parameters, 
typedef struct _WNDPARAMS { 


USHORT 

fsStatus; 

/* 

Window parameter selection */ 

USHORT 

cchText; 

/* 

Length of window text */ 

PSZ 

pszText; 

/* 

Window text */ 

USHORT 

cbPresParams; 

/* 

Length of presentation parameters 
*/ 

PVOID 

pPresParams; 

/* 

Presentation parameters */ 

USHORT 

cbCtlData; 

/* 

Length of window class specific 
data */ 

PVOID pCtlData; 

> WNDPARAMS; 

/* 

Window class specific data */ 


Window-procedure identifier. 
(Maps via PFNWP) 

Window point structure (integer), 
typedef struct _WP0INT { 


SHORT 

x; 

/* 

x coordinate 

*/ 

SHORT 

dummyl; 

/* 

Reserved */ 


SHORT 

y; 

/* 

y coordinate 

*/ 

SHORT 
} WPOINT; 

dummy2; 

/* 

Reserved */ 


Window rectangle structure (integer), 
typedef struct _WRECT { 


SHORT 

xLeft ; 

/* 

x coordinate 
rectangle */ 

of left-hand edge of 

SHORT 

dummyl; 

/* 

Reserved */ 


SHORT 

yBottom; 

/* 

y coordinate 

*/ 

of bottom edge of rectangle 

SHORT 

dummy2; 

/* 

Reserved */ 


SHORT 

xRight; 

/* 

x coordinate 
rectangle */ 

of right-hand edge of 

SHORT 

dummy3 ; 

/* 

Reserved */ 


SHORT 

yTop; 

/* 

y coordinate 

of top edge of rectangle */ 

SHORT 
} WRECT; 

dummy 4; 

/* 

Reserved */ 
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XYWINSIZE 


Window position and size structure, 
typedef struct _XYWINSIZE { 


SHORT 

x; 

/* 

x coordinate of window origin */ 

SHORT 

y; 

/* 

y coordinate of window origin */ 

SHORT 

cx; 

/* 

Window width */ 

SHORT 

cy; 

/* 

Window height */ 

USHORT 

fsWindow; 

/* 

Window options */ 


} XYWINSIZE; 
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Chapter 3. Device Function Calls 


DevCIoseDC 

#define INCL_DEV /* Or use INCL_PM. Also in COMMON section */ 

HMF hmf = DevCIoseDC (hdc) 

HDC hdc; /* Device-context handle */ 

HMF hmf; /* Error indicator/metafile handle (for a metafile device context) */ 


DevEscape 

^define INCL_DEV /* Or use INCL.PM */ 

LONG 1 Result = DevEscape (hdc, ICode, 1 InCount, pblnData, plOutCount, pbOutData) 

HDC hdc; /* Device-context handle */ 

LONG ICode; /* Escape code */ 

LONG 1 InCount; /* Input data count */ 

PBYTE pblnData; /* The input data required for this escape */ 

PLONG plOutCount; /* Output data count */ 

PBYTE pbOutData; /* Output data */ 

LONG 1 Result; /* Implemented/error indicator */ 


DevOpenDC 

#defi ne INCLJJEV /* Or use INCL.PM, Also in COMMON section it/ 

HDC hdc = DevOpenDC (hab, lType, pszToken, 1 Count, pdopData, hdcComp) 

HAB hab; /it Anchor-block handle */ 

LONG lType; /it Type of device context */ 

PSZ pszToken; /* Device-information token it/ 

LONG 1 Count; /* Number of items it/ 

PDEVOPENDATA pdopData; /it Open-device-context data area it/ 

HDC hdcComp; /* Compatible-device-context handle */ 

HDC hdc; /* Device-context handle */ 


DevPostDeviceModes 

#define INCL_DEV /* Or use INCL_PM */ 

LONG IDriverCount = DevPostDeviceModes (hab, pdri vDri verData, pszDri verName, 

pszDeviceName, pszName, fl Opt ions) 


HAB 

hab; 

/* Anchor-block handle it/ 

PDRIVDATA 

pdri vDri verData; 

/it Driver data it/ 

PSZ 

pszDri verName; 

/it This is a string containing the name of the presentation 
device driver it/ 

PSZ 

pszDeviceName; 

/it Device-type name */ 

PSZ 

pszName; 

/it Device name it/ 

ULONG 

fl Opt ions; 

/it Dialog options it/ 

LONG 

IDriverCount; 

/it Size/error indicator */ 
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DevQueryCaps 

#define INCLJDEV /* Or use INCL_PM. Also in COMMON section */ 

BOOL fSuccess = DevQueryCaps (hdc, 1 Start, 1 Count, al Array) 

HDC hdc; /* Device-context handle */ 

LONG 1 Start; /* First item of information */ 

LONG 1 Count; /* Count of items of information */ 

PLONG al Array; /* Device capabilities */ 

BOOL fSuccess; /* Success indicator */ 

DevQueryDeviceNames 

^define INCL_DEV /* Or use INCL_PM */ 

BOOL fSuccess = DevQueryDeviceNames (hab, pszDriverName, pldn, aDeviceName, aDeviceDesc, 

pldt, aDataType) 

HAB hab; /* Anchor-block handle */ 

PSZ pszDriverName; /* Fully qualified name of the file containing the presentation 

driver */ 

PLONG pldn; /* Maximum number of device names and descriptions that can be 

returned */ 

PSTR32 aDeviceName; /* Device-name array */ 

PSTR64 aDeviceDesc; /* Device description array */ 

PLONG pldt; /* Maximum number of data types that can be returned */ 

PSTR16 aDataType; /* Data type array */ 

BOOL fSuccess; /* Success indicator */ 

DevQueryHardcopyCaps 

#define INCL_DEV /* Or use INCL_PM */ 

LONG lFormsReturned = DevQueryHardcopyCaps (hdc, IStartForm, 1 Forms, phciHclnfo) 

HDC hdc; /* Device-context handle */ 

LONG IStartForm; /* Start-forms code a/ 

LONG 1 Forms; /* Number of forms to query */ 

PHCINFO phciHclnfo; /* Hardcopy capabilities information */ 

LONG lFormsReturned; /* Details of forms */ 
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Chapter 4. Graphics Presentation Interface Function 
Calls 


GpiAssociate 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = GpiAssociate (hps, hdc) 

HPS hps; /* Presentation-space handle */ 

HDC hdc; /* Device-context handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiBeginArea 

Idefine INCLGPIPRIMITIVES /* Or use INCL_GPI or INCL_PM. Also in COITION section */ 

BOOL fSuccess = GpiBeginArea (hps, fl Options) 

HPS hps; /* Presentation-space handle */ 

ULONG fl Opt ions; /* Area options */ 

BOOL fSuccess; /* Success indicator */ 


GpiBeginElement 

#define INCLJaPISEGEDITING /* Or use INCLJ3PI or INCL_PM */ 

BOOL fSuccess = GpiBeginElement (hps, IType, pszDesc) 

HPS hps; /* Presentation-space handle */ 

LONG IType; /* Type to be associated with element */ 

PSZ pszDesc; /* Description */ 

BOOL fSuccess; /* Success indicator */ 


GpiBeginPath 

^define INCLGPIPATHS /* Or use INCL.GPI or INCL.PM */ 

BOOL fSuccess = GpiBeginPath (hps, IPath) 

HPS hps; /* Presentation-space handle */ 

LONG IPath; /* Path identifier */ 

BOOL fSuccess; /* Success indicator */ 


GpiBitBIt 

#def i ne INCL_GPIBITMAPS /it Or use INCL_GPI or INCL_PM. Also in COMMON section it/ 
LONG lHits = GpiBitBIt (hpsTarget, hpsSource, 1 Count, apt! Points, IRop, fl Options) 


HPS 

hpsTarget; 

/* Target presentation-space handle */ 

HPS 

hpsSource; 

/it Source presentation-space handle */ 

LONG 

1 Count; 

/it Point count it/ 

PPOINTL 

aptl Points; 

/* Point array it/ 

LONG 

IRop; 

/it Mixing function required */ 

ULONG 

fl Options; 

/it Options it/ 

LONG 

lHits; 

/it Correlation/error indicator */ 
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GpiBox 

#define INCL_GPIPRIMITIVES /* Or use INCL.GPI or INCL_PM. Also in COMMON section */ 
LONG IHits = GpiBox (hps, 1 Control, pptl Point, lHRound, lVRound) 


HPS 

hps; 

/it Presentation-space handle */ 

LONG 

1 Control ; 

/it Outline and fill control 

*/ 

PPOINTL 

pptlPoint; 

/* Corner point it/ 


LONG 

lHRound; 

/it Corner-rounding control 

*/ 

LONG 

1 VRound; 

/it Corner-rounding control 

*/ 

LONG 

IHits; 

/it Correlation/error indicator it/ 


GpiCallSegmentMatrix 

Idefine INCL_GPITRANSFORMS /* Or use INCL_GPI or INCL_PM */ 

LONG IHits = GpiCallSegmentMatrix (hps, lSegment, ICount, pmatlfArray, lOptions) 

HPS hps; /* Presentation-space handle */ 

LONG lSegment; /* Identifier of segment to be called */ 

LONG ICount; /* Number of elements */ 

PMATRIXLF pmatlfArray; /* Instance transform matrix */ 

LONG lOptions; /* Transformation options */ 

LONG IHits; /* Correlation/error indicator */ 


GpiCharString 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

LONG IHits = GpiCharString (hps, ICount, pchString) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /* Number of characters */ 

PCH pchString; /* Characters to be drawn */ 

LONG IHits; /* Correlation/error indicator */ 


GpiCharStringAt 

Idefine INCL_GPIPRIMITIVES /* Or use INCLJ3PI or INCL_PM. Also in COMMON section */ 

LONG IHits = GpiCharStringAt (hps, pptlPoint, ICount, pchString) 

HPS hps; /if Presentation-space handle */ 

PPOINTL pptlPoint; /it Starting position */ 

LONG ICount; /it Number of characters */ 

PCH pchString; /it Characters to be drawn */ 

LONG IHits; /it Correlation/error indicator it/ 


GpiCharStringPos 

#define INCL_GPIPRIMITIVES /* Or use INCLJ3PI or INCL_PM it/ 

LONG IHits = GpiCharStringPos (hps, prclRect, flOptions, ICount, pchString, alAdx) 

HPS hps; /it Presentation-space handle */ 

PRECTL prclRect; /* Rectangle structure it/ 

ULONG flOptions; /* Formatting options */ 

LONG ICount; /* Number of characters in the string */ 

PCH pchString; /it Character string */ 

PLONG alAdx; /it Increment values */ 

LONG IHits; /* Correlation/error indicator it/ 
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GpiCharStringPosAt 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Hits » GpiCharStringPosAt (hps, pptlStart, prclRect, flOptions, ICount, pchString, 

alAdx) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptlStart; /* Starting position */ 

PRECTL prclRect; /* Rectangle structure */ 

ULONG flOptions; /* Formatting options */ 

LONG ICount; /* Number of characters in the string */ 

PCH pchString; /* Character string */ 

PLONG alAdx; /* Increment values */ 

LONG lHits; /* Correlation/error indicator */ 


GpiCloseFigure 

fdefine INCL_GPIPATHS /* Or use INCL_GPI or INCL_PH */ 
BOOL fSuccess = GpiCloseFigure (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiCloseSegment 

fdefine INCL_GPISEGMENTS /* Or use INCL.GPI or INCL_PM */ 
BOOL fSuccess = GpiCloseSegment (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiCombineRegion 

fdefine INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM */ 

LONG IComplexity = GpiCombineRegion (hps, hrgnDest, hrgnSrcl, hrgnSrc2, IMode) 

HPS hps; /* Presentation-space handle */ 

HRGN hrgnDest; /* Destination-region handle */ 

HRGN hrgnSrcl; /* First-source- region handle */ 

HRGN hrgnSrc2; /* Second-source-region handle */ 

LONG IMode; /* Method of combination */ 

LONG IComplexity; /* Complexity of resulting region/error indicator */ 


GpiComment 

#def i ne INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiComment (hps, lLength, pbData) 

HPS hps; /* Presentation-space handle */ 

LONG lLength; /* Data length */ 

PBYTE pbData; /* Comment data */ 

BOOL fSuccess; /* Success indicator */ 
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GpiConvert 

#define INCL_GPITRANSFORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiConvert (hps, ISrc, ITarg, ICount, aptlPoints) 

HPS hps; /* Presentation-space handle */ 

LONG ISrc; /* Source-coordinate space */ 

LONG ITarg; /* Target-coordinate space */ 

LONG 1 Count; /* Point count */ 

PPOINTL aptlPoints; /* Array of (x,y) coordinate pair structures */ 

BOOL fSuccess; /* Success indicator */ 

GpiCopyMetaFile 

#define INCL_GPIMETAFILES /* Or use INCL_GPI or INCL_PM */ 

HMF hmfNew = GpiCopyMetaFile (hmf) 

HMF hmf; /* Source metafile handle */ 

HMF hmfNew; /* New metafile handle/error indicator */ 

GpiCorrelateChain 

#define I NCL_GP I CORRELATION /* Or use INCL_GPI or INCL_PM */ 

LONG INumHits = GpiCorrelateChain (hps, IType, pptlPick, IMaxHits, IMaxDepth, alSegTag) 

HPS hps; /* Presentation-space handle */ 

LONG IType; /* Segment type */ 

PPOINTL pptlPick; /* Pick position */ 

LONG IMaxHits; /* Maximum hits */ 

LONG IMaxDepth; /* Number of pairs */ 

PLONG alSegTag; /* Segment identifiers and tags */ 

LONG INumHits; /* Number of hits or error */ 

GpiCorrelateFrom 

#define INCLJjPICORRELATION /* Or use INCL_GPI or INCL_PM */ 

LONG INumHits = GpiCorrelateFrom (hps, 1 Fi rstSegment , lLastSegment, IType, pptlPick, 

IMaxHits, IMaxDepth, alSegTag) 

HPS hps; /i: Presentation-space handle */ 

LONG IFi rstSegment; /* Specifies the first segment to be correlated */ 

LONG lLastSegment; /* Specifies the last segment to be correlated */ 

LONG IType; /ie The type of segments on which correlation is to be performed */ 

PPOINTL pptlPick; /* Pick position */ 

LONG IMaxHits; /ie Maximum hits */ 

LONG IMaxDepth; /ie Number of pairs */ 

PLONG alSegTag; /* An array of segment and tag identifiers in alternate elements */ 

LONG INumHits; /* Number of hits, or error */ 
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GpiCorrelateSegment 

^define I NCL_GP I CORRELATION /* Or use INCL_GPI or INCL_PM */ 

LONG lNumHits = GpiCorrelateSegment (hps, lSegment, lType, pptlPick, IMaxHits, IMaxDepth, 

alSegTag) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Segment; /* Identifier of the segment to be correlated; it must be greater than 0 
*/ 

LONG lType; /* Type of segments on which correlation is to be performed */ 

PPOINTL pptlPick; /* Position of the center of the pick aperture in presentation page 

space */ 

LONG IMaxHits; /* Maximum hits */ 

LONG IMaxDepth; /* Number of segment and tag pairs to be returned for each hit */ 

PLONG alSegTag; /* Array */ 

LONG lNumHits; /* Number of hits, or error */ 


GpiCreateBitmap 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

HBITMAP hbm = GpiCreateBitmap (hps, pbmpNew, fl Options, pblnitData, pbmi InfoTable) 

HPS hps; /* Presentation-space handle */ 

PBITMAPINFOHEADER pbmpNew; /* Bit-map information header */ 

ULONG fl Options; /* Options */ 

PBYTE pblnitData; /* Buffer address */ 

PBITMAPINFO pbmi InfoTable; /* Bit-map information table */ 

HBITMAP hbm; /* Bit-map handle/error indicator */ 


GpiCreateLogColorTable 

#define INCL_GPILOGCOLORTABLE /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiCreateLogColorTable (hps, fl Options, 1 Format, 1 Start, 1 Count, al Table) 

HPS hps; /* Presentation-space handle */ 

ULONG fl Options; /* Options */ 

LONG 1 Format; /* Format of entries in the table */ 

LONG 1 Start; /* Starting index */ 

LONG 1 Count; /* Count of elements in Table */ 

PLONG alTable; /* Start of the application data area */ 

BOOL fSuccess; /* Success indicator */ 


GpiCreateLogFont 

#define INCL_GPILCID$ /* Or use INCL.GPI or INCL.PM */ 

LONG IMatch = GpiCreateLogFont (hps, pName, ILcid, pfatAttrs) 

HPS hps; /* Presentation-space handle */ 

PSTR8 pName; /* Logical font name */ 

LONG ILcid; /* Local identifier */ 

PFATTRS pfatAttrs; /* Attributes of font */ 

LONG IMatch; /* Match indicator */ 
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GpiCreatePS 

^define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

HPS hps = GpiCreatePS (hab, hdc, psizlSize, flOptions) 

HAB hab; /* Anchor-block handle */ 

HDC hdc; /* Device-context handle */ 

PSIZEL psizlSize; /* Presentation-page size */ 

ULONG flOptions; /* Options */ 

HPS hps; /* Presentation-space handle */ 

GpiCreateRegion 

#define INCL_GPIREGIONS /* Or use INCLJSPI or INCL_PM */ 

HRGN hrgn * GpiCreateRegion (hps, 1 Count, arcl Rectangles) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Count; /* The number of rectangles */ 

PRECTL arcl Rectangles; /* An array of rectangles */ 

HRGN hrgn; /* Region handle */ 


GpiDeleteBitmap 

#define INCLJ5PIBITMAPS /* Or use INCLJ3PI or INCL_PM. Also in COMMON section */ 
BOOL f Success = GpiDeleteBitmap (hbm) 

HBITMAP hbm; /* Handle of bit map to be deleted */ 

BOOL fSuccess; /* Success indicator */ 


GpiDeleteElement 

#define INCL.GPISEGEDITING /* Or use INCL_GPI or INCL.PM */ 
BOOL fSuccess = GpiDeleteElement (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiDeleteEiementRange 

#define INCL_GPISE6EDITING /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiDeleteEiementRange (hps, 1 FirstElement, lLastElement) 

HPS hps; (it Presentation-space handle */ 

LONG 1 FirstElement; /* Number of the first element to be deleted it! 

LONG lLastElement; lie Number of the last element to be deleted */ 

BOOL fSuccess; /* Success indicator */ 


Gpi DeleteElementsBetweenLabels 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = Gpi DeleteElementsBetweenLabels (hps, IFirstLabel, ILastLabel) 
HPS hps; lie Presentation-space handle */ 

LONG IFirstLabel; /* Label marking the start of the elements to be deleted */ 

LONG ILastLabel; lie Label marking the end of the elements to be deleted */ 

BOOL fSuccess; lie Success indicator */ 
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GpiDeleteMetaFile 

fdefine INCL_GPIMETAFILES /* Or use INCL_GPI or INCL.PM */ 

BOOL f Success = GpiDeleteMetaFile (hmf) 

HMF hmf; /* Metafile handle */ 

BOOL f Success; /* Success indicator */ 

GpiDeleteSegment 

#define INCL_GPISEGMENTS /* Or use INCL.GPI or INCL_PM */ 

BOOL f Success = GpiDeleteSegment (hps, lSegid) 

HPS hps; /* Presentation-space handle */ 

LONG lSegid; /* Segment identifier */ 

BOOL f Success; /* Success indicator */ 

GpiDeleteSegments 

#def i ne I NCLJjP I SEGMENTS /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess s GpiDeleteSegments (hps, 1 First Segment, ILastSegment) 

HPS hps; /* Presentation-space handle */ 

LONG IFirstSegment; /* First identifier in the range; it must be greater than 0 */ 
LONG ILastSegment; /* Last identifier in the range; it must be greater than 0 */ 

BOOL fSuccess; /* Success indicator */ 

GpiDeleteSetld 

^define INCL_GPILCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiDeleteSetld (hps, ILcid) 

HPS hps; /ic Presentation-space handle */ 

LONG ILcid; /* Local identifier ie/ 

BOOL fSuccess; /* Success indicator */ 

Gpi Destroy PS 

^define INCL_GPICONTROL /ie Or use INCLJSPI or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = GpiDestroyPS (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 

GpiDestroyRegion 

#define INCL^GPIREGIONS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiDestroyRegion (hps, hrgn) 

HPS hps; lie Presentation-space handle */ 

HRGN hrgn; /* Handle of region to be destroyed ie/ 

BOOL fSuccess; /* Success indicator */ 

GpiDrawChain 

#def i ne INCL_GPISEGMENTS /ie Or use INCL.GPI or INCL_PM */ 

BOOL fSuccess = GpiDrawChain (hps) 

HPS hps; /ie Presentation-space handle */ 

BOOL fSuccess; /ie Success indicator */ 
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GpiDrawDynamics 

#define INCLJ3PISEGMENTS /* Or use INCLJ3PI or INCL_PM */ 
BOOL fSuccess = GpiDrawDynamics (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiDrawFrom 

#define I NCL_GPI SEGMENTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiDrawFrom (hps, 1 First Segment, lLastSegment) 

HPS hps; /* Presentation-space handle */ 

LONG lFirstSegment; /* First segment to be drawn; it must be greater than zero */ 
LONG lLastSegment; /* Last segment to be drawn; it must be greater than zero */ 

BOOL fSuccess; /* Success indicator */ 


GpiDrawSegment 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiDrawSegment (hps, 1 Segment) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Segment; /* Segment to be drawn; it must be greater than zero */ 
BOOL fSuccess; /* Success indicator */ 


GpiElement 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

LONG IHits = GpiElement (hps. Hype, pszDesc, 1 Length, pbData) 

HPS hps; /* Presentation-space handle */ 

LONG lType; /it Type to be associated with the element */ 

PSZ pszDesc; /it Element description */ 

LONG 1 Length; /* Length of content data for the element it/ 
PBYTE pbData; /* Buffer pointer is/ 

LONG IHits; /it Correlation/error indicator */ 


GpiEndArea 

#define INCL^GPIPRIMITIVES /* Or use INCL.GPI or INCL_PM. Also in COMMON section it/ 
LONG IHits = GpiEndArea (hps) 

HPS hps; /is Presentation-space handle */ 

LONG IHits; /it Correlation/error indicator */ 


GpiEndElement 

#define INCL_GPISEGEDITING /is Or use INCL_GPI or INCL.PM */ 
BOOL fSuccess = GpiEndElement (hps) 

HPS hps; /is Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 
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GpiEndPath 

#def i ne INCL_GPIPATHS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiEndPath (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiEqualRegion 

^define INCL_GPIREGIONS /* Or use INCL_GPI or INCL.PM */ 

LONG 1 Equality = GpiEqualRegion (hps, hrgnSrcl, hrgnSrc2) 

HPS hps; /* Presentation-space handle */ 

HRGN hrgnSrcl; /* Handle of first region */ 

HRGN hrgnSrc2; /* Handle of second region */ 

LONG 1 Equality; /* Equal i ty /error indicator */ 


GpiErase 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = GpiErase (hps) 

HPS hps; /* Presentation-space handle it/ 

BOOL fSuccess; /* Success indicator */ 


GpiErrorSegmentData 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM */ 

LONG lOff = GpiErrorSegmentData (hps, pi Segment, pi Context) 

HPS hps; /if Presentation-space handle */ 

PLONG pi Segment; /* Segment in which the error occurred */ 

PLONG pi Context; /* Context of the error it/ 

LONG lOff; /if Position */ 


GpiExcludeClipRectangle 

#def i ne INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Complexity = GpiExcludeClipRectangle (hps, prcl Rectangl e) 

HPS hps; /it Presentation-space handle */ 

PRECTL prcl Rectangle; /it Rectangle to be excluded it/ 

LONG 1 Complexity; /it Complexity of clipping/error indicator */ 

GpiFillPath 

#define INCL^GPI PATHS /* Or use INCL_GPI or INCLJM */ 

LONG lHits = GpiFillPath (hps, IPath, lOptions) 

HPS hps; /it Presentation-space handle */ 

LONG IPath; /* Identifier of path whose interior is to be drawn; it must be 1 */ 

LONG lOptions; /it Fill option it/ 

LONG lHits; /* Error indicator */ 
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GpiFullArc 

Idefine INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG lHits = GpiFullArc (hps, IControl, fxMultiplier) 

HPS hps; /* Presentation-space handle */ 

LONG IControl; /* Interior/outl ine control */ 

FIXED fxMultiplier; /* Multiplier */ 

LONG lHits; /* Correlation/error indicator */ 


GpiGetData 

Idefine INCL_GPISEGMENTS /* Or use INCL_GPI or INCL_PM */ 

LONG ICount = GpiGetData (hps, ISegid, plOffset, IFormat, 1 Length, pbData) 

HPS hps; /* Presentation-space handle */ 

LONG ISegid; /* Segment identifier */ 

PLONG plOffset; /ie Segment offset */ 

LONG IFormat; /* Coordinate type required ie/ 

LONG 1 Length; /ie Length of data buffer ie/ 

PBYTE pbData; /* Data buffer ie/ 

LONG ICount; /* Length of returned data ie/ 


Gpilmage 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG lHits = Gpilmage (hps, IFormat, psizl ImageSize, 1 Length, pbData) 

HPS hps; /ie Presentation-space handle */ 

LONG IFormat; /* Format of image data */ 

PSIZEL psizl ImageSize; /ie Size of image area (in pels) ie/ 

LONG 1 Length; /* Length in bytes of image data */ 

PBYTE pbData; /* Image data */ 

LONG lHits; /* Correlation/error indicator ie/ 


GpilntersectClipRectangle 

#define INCL_GPIREGIONS /ie Or use INCLJ5PI or INCL_PM */ 

LONG 1 Complexity = GpilntersectClipRectangle (hps, prcl Rectangle) 

HPS hps; /ie Presentation-space handle */ 

PRECTL prcl Rectangle; /* Rectangle, the coordinates of which are world coordinates */ 
LONG 1 Complexity; tie Complexity of clipping/error indicator */ 


GpiLabel 

#define INCL.GPISEGEDITING /ie Or use INCL.GPI or INCL_PM */ 

BOOL f Success = GpiLabel (hps, 1 Label) 

HPS hps; /ie Presentation-space handle ie/ 

LONG 1 Label; /ie Required label ie/ 

BOOL fSuccess; /* Success indicator ie/ 


GpiUne 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCLJ>M. Also in COMMON section */ 

LONG lHits = GpiLine (hps, pptl EndPoint) 

HPS hps; lie Presentation-space handle */ 

PPOINTL pptl EndPoint; /* End point of the line ie/ 

LONG lHits; /* Correlation/error indicator */ 
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GpiLoadBitmap 

^define INCLJ3PIBITMAPS /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 
HBITMAP hbm = GpiLoadBitmap (hps, Resource, idBitmap, 1 Width, 1 Height) 


HPS 

HMODULE 

USHORT 

LONG 

LONG 


hps; /* Presentation-space handle */ 

Resource; /* Resource identity containing the bit map */ 
idBitmap; /* ID of the bit map within the resource file */ 
1 Width; /* Width of the bit map in pels */ 

1 Height; /* Height of the bit map in pels */ 


HBITMAP hbm; /if Bit-map handle */ 


GpiLoadFonts 

^define INCLJ3PILCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiLoadFonts (hab, pszFilename) 

HAB hab; /* Anchor-block handle it/ 

PSZ pszFilename; /* Filename it/ 

BOOL fSuccess; /* Success indicator it/ 


GpiLoadMetaFile 

#define INCLJ5PIMETAFILES /it Or use INCL_GPI or INCL.PM */ 

HMF hmf = GpiLoadMetaFile (hab, pszFilename) 

HAB hab; /* Anchor-block handle it/ 

PSZ pszFilename; /* Filename it/ 

HMF hmf; /* Metafile handle or error */ 


GpiMarker 

#define INCL_GPIPRIMITIVES /* Or use INCL^GPI or INCL_PM */ 

LONG 1 Hits = GpiMarker (hps, pptlPoint) 

HPS hps; /it Presentation-space handle it/ 

PPOINTL pptlPoint; /* Position of the marker */ 

LONG IHits; /it Correlation/error indicator */ 


Gpi Modify Path 

Idefine INCL.GPIPATHS /it Or use INCLJ5PI or INCL_PM */ 


BOOL fSuccess = GpiModifyPath (hps, IPath, IMode) 


HPS hps; 
LONG IPath; 
LONG IMode; 


/it Presentation-space handle it/ 
/it Path identifier */ 

/it Modification required */ 


BOOL fSuccess; /* Success indicator */ 


GpiMove 

#define INCL_GPIPRIMITIVES /it Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = GpiMove (hps, pptlPoint) 

HPS hps; /it Presentation-space handle */ 

PPOINTL pptlPoint; /* Position to which to move */ 

BOOL fSuccess; /it Success indicator */ 
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GpiOffsetClipRegion 

#define INCL_GPIREGIONS /* Or use INCLJSPI or INCL_PM */ 

LONG IComplexity = GpiOffsetClipRegion (hps, pptlPoint) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptlPoint; /* Displacement */ 

LONG IComplexity; /* Complexity of clipping/error indicator */ 


GpiOffsetElementPointer 

#define INCLJSPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success - GpiOffsetElementPointer (hps, 1 offset) 

HPS hps; /* Presentation-space handle */ 

LONG 1 offset; /* Offset to be added to the element pointer */ 

BOOL f Success; /* Success indicator */ 


GpiOffsetRegion 

#define INCL.GPIREGIONS /* Or use INCLGPI or INCL_PM */ 

BOOL fSuccess = GpiOffsetRegion (hps, Hrgn, pptlOffset) 

HPS hps; /* Presentation-space handle */ 

HRGN Hrgn; /* Region handle to be moved */ 

PPOINTL pptlOffset; /* Offset to be added to the region boundary */ 

BOOL fSuccess; /* Success indicator */ 


GpiOpenSegment 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiOpenSegment (hps, 1 Segment) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Segment; /* Segment identifier */ 

BOOL fSuccess; /* Success indicator */ 


GpiOutlinePath 

#define INCL_GPIPATHS /* Or use INCL_GPI or INCL_PM */ 

LONG IHits = GpiOutlinePath (hps, IPath, lOptions) 

HPS hps; /* Presentation-space handle */ 

LONG IPath; /* Identifier of path to be outlined; it must be 1 */ 

LONG lOptions; /* Options */ 

LONG IHits; /it Correlation/error indicator */ 


GpiPaintRegion 

#define INCL_GPIREGIONS /it Or use INCLJ3PI or INCL_PM */ 

LONG IHits = GpiPaintRegion (hps, hrgn) 

HPS hps; /it Presentation-space handle it/ 

HRGN hrgn; /* Region handle it/ 

LONG IHits; /* Correlation/error indicator */ 
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GpiPartialArc 

#define INCL_GPIPRIMITIVE$ /* Or use INCLGPI or INCL.PM */ 

LONG IHits = GpiPartialArc (hps, pptlCenter, fxMultiplier, fxStartAngle, f xSweepAngl e) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptlCenter; /* Center point */ 

FIXED fxMultiplier; /* Multiplier */ 

FIXED fxStartAngle; /* Start angle in degrees */ 

FIXED fxSweepAngle; /* Sweep angle in degrees */ 

LONG IHits; /* Correlation/error indicator */ 


GpiPlayMetaFile 

^define INCL_GPIMETAFILES /* Or use INCL_GPI or INCL_PM */ 

LONG IHits = GpiPlayMetaFile (hps, hmf, lCountl, al Optarray, plSegCount, lCount2, pszDesc) 

HPS hps; /* Presentation-space handle */ 

HMF hmf; /* Metafile handle */ 

LONG lCountl; /* Count of elements in Optarray */ 

PLONG al Optarray; /* Array of options for playing */ 

PLONG plSegCount; /* Reserved it/ 

LONG lCount2; /* Count of bytes in Desc */ 

PSZ pszDesc; /it Descriptive record */ 

LONG IHits; /* Correlation/error indicator */ 


GpiPointArc 

#define INCLJ5PIPRIMITIVES /* Or use INCL.GPI or INCL_PM */ 

LONG IHits = GpiPointArc (hps, aptlPoints) 

HPS hps; fit Presentation-space handle it/ 

PPOINTL aptlPoints; /* Intermediate and end points */ 

LONG IHits; /* Correlation/error indicator it/ 


GpiPolyFillet 

Idefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG IHits = GpiPolyFillet (hps, ICount, aptlPoints) 

HPS hps; /it Presentation-space handle it/ 

LONG ICount; /* Number of points */ 

PPOINTL aptlPoints; /* Array of points */ 

LONG IHits; /it Correlation/error indicator */ 


GpiPolyFilletSharp 

#define INCL^GPI PRIMITIVES /it Or use INCLJ3PI or INCLPM it/ 

LONG IHits = GpiPolyFilletSharp (hps, ICount, aptlPoints, afxSharpness) 

HPS hps; /it Presentation-space handle */ 

LONG ICount; /it Count of points it/ 

PPOINTL aptlPoints; /* An array of points */ 

PFIXED afxSharpness; /it Array of sharpness values it/ 

LONG IHits; /it Correlation/error indicator */ 
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GpiPolyLine 

#define INCL_GPIPRIMITIVES /* Or use INCL.GPI or INCL_PM. Also in COMMON section */ 

LONG 1 Hits = GpiPolyLine (hps, ICount, aptlPoints) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /* Number of points */ 

PPOINTL aptlPoints; /* Array of points */ 

LONG 1 Hi ts ; /* Correlation/error indicator */ 


GpiPolyMarker 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Hi ts = GpiPolyMarker (hps, ICount, aptlPoints) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /* Number of points */ 

PPOINTL aptlPoints; /* Array of points */ 

LONG 1 Hi ts ; /* Correlation/error indicator */ 


GpiPolySpline 

#define INCLJSPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Hi ts = GpiPolySpline (hps, ICount, aptlPoints) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /* Count of points */ 

PPOINTL aptlPoints; /* An array of points */ 

LONG 1 Hi ts ; /* Correlation/error indicator */ 


GpiPop 

#define INCLJSPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiPop (hps, ICount) 

HPS hps; fie Presentation-space handle */ 

LONG ICount; tic Number of attributes to be restored */ 

BOOL f Success; /* Success indicator */ 


GpiPtlnRegion 

#define INCL_GPIREGIONS fie Or use INCL_GPI or INCL_PM iet 

LONG 1 Inside = GpiPtlnRegion (hps, hrgn, pptl Point) 

HPS hps; tie Presentation-space handle ★/ 

HRGN hrgn; /* Region handle ief 

PPOINTL pptl Point; tie Point to be checked */ 

LONG 1 Inside; /* Inside/error indicator */ 


GpiPtVisible 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Visibility = GpiPtVisible (hps, pptl Point) 

HPS hps; tie Presentation-space handle */ 

PPOINTL pptlPoint; /* Point to be checked */ 

LONG lVisibility; /* Visibility indicator */ 
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GpiPutData 

#define I NCL_GP I SEGMENTS /* Or use INCL.GPI or INCL_PM */ 

LONG lHits = GpiPutData (hps, 1 Format, pi Length, pbData) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Format; /* Coordinate type used */ 

PLONG pi Length; /* Length of graphic data */ 

PBYTE pbData; /* Orders to be copied */ 

LONG lHits; /* Correlation/error indicator */ 


GpiQueryArcParams 

fdefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQueryArcParams (hps, parcpArcParams) 

HPS hps; /* Presentation-space handle */ 

PARC P ARAMS parcpArcParams; /* Arc parameters */ 

BOOL f Success; /* Success indicator */ 


GpiQueryAttrMode 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG IMode = GpiQueryAttrMode (hps) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Current attribute mode */ 

GpiQueryAttrs 

#define INCL_GPIPRIMITIVES /* Or use INCLJ3PI or INCL.PM */ 

LONG IDefMask = GpiQueryAttrs (hps, IPrimType, flAttrMask, ppbunAttrs) 

HPS hps; /* Presentation-space handle */ 

LONG IPrimType; /* Primitive type */ 

ULONG flAttrMask; /* Attributes mask */ 

PBUNDLE ppbunAttrs; /* Attributes */ 

LONG IDefMask; /* Defaults mask */ 


GpiQueryBackColor 

#define INCL_GPIPRIMITIVES /* Or use INCLGPI or INCLJ>M */ 
LONG 1 Col or s GpiQueryBackColor (hps) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Col or; /* Background color */ 


GpiQueryBackMix 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 
LONG IMixMode = GpiQueryBackMix (hps) 

HPS hps; /* Presentation-space handle */ 

LONG IMixMode; /* Background mix */ 
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GpiQueryBitmapBits 

^define INCL_6PIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

LONG IScansReturned = GpiQueryBitmapBits (hps, IScanStart, IScans. pbBuffer, 

pbmilnfoTable) 

HPS hps; /* Presentation-space handle */ 

LONG IScanStart; /* Starting line number */ 

LONG IScans; /* Number of scan lines to be returned */ 

PBYTE pbBuffer; /* Data area */ 

PBITMAPINFO pbmilnfoTable; /* Bit-map information table */ 

LONG IScansReturned; /* Number of scan lines actually returned */ 

GpiQueryBitmapDimension 

#define I NCLGPI BITMAPS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryBitmapDimension (hbm, psizlBitmapDimension) 

HBITMAP hbm; /* Bit-map handle */ 

PSIZEL psizlBitmapDimension; /* Size of bit map */ 

BOOL fSuccess; /* Success indicator */ 

GpiQueryBitmapHandle 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

HBITMAP hbm = GpiQueryBitmapHandle (hps, ILcid) 

HPS hps; /* Presentation-space handle if/ 

LONG ILcid; /* Local identifier */ 

HBITMAP hbm; /* Bit-map handle */ 

GpiQueryBitmapParameters 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryBitmapParameters (hbm, pbmpData) 

HBITMAP hbm; /* Bit-map handle */ 

PBITMAPINFOHEADER pbmpData; /* Bit-map information header */ 

BOOL fSuccess; /* Success indicator */ 

GpiQueryBoundaryData 

#define I NCL_GP I CORRELATION /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryBoundaryData (hps, prcl Boundary) 

HPS hps; /if Presentation-space handle */ 

PRECTL prcl Boundary; /* Boundary data */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryCharAngle 

#define INCL_GPIPRIMITIVES /* Or use INCL.GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryCharAngle (hps, pgradl Angle) 

HPS hps; /if Presentation-space handle */ 

PGRADIENTL pgradl Angle; /* Baseline angle */ 

BOOL fSuccess; /it Success indicator it/ 
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GpiQueryCharBox 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQueryCharBox (hps, psizfxSize) 

HPS hps; /* Presentation-space handle */ 

PSIZEF psizfxSize; /* Character-box size */ 

BOOL f Success; /* Success indicator */ 


GpiQueryCharDirection 

Idefine INCL^GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 
LONG 1 Direction = GpiQueryCharDirection (hps) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Direction; /* Character direction */ 

GpiQueryCharMode 

Idefine INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG IMode = GpiQueryCharMode (hps) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Character mode */ 

GpiQueryCharSet 

Idefine INCLJ5PIPRIMITIVES /* Or use INCL_GPI or INCL.PM */ 
LONG ILcid = GpiQueryCharSet (hps) 

HPS hps; lie Presentation-space handle */ 

LONG ILcid; lie Character-set local identifier */ 

GpiQueryCharShear 

Idefine INCL_GPI PRIMITIVES /* Or use INCLJ5PI or INCL.PM */ 

BOOL f Success - GpiQueryCharShear (hps, pptl Shear) 

HPS hps; /it Presentation-space handle */ 

PPOINTL pptl Shear; /* Character shear */ 

BOOL f Success; tie Success indicator */ 


GpiQueryCharStringPos 

Idefine INCL^GPIPRIMITI VES /* Or use INCL_GPI or INCL_PM */ 


BOOL fSuccess = GpiQueryCharStringPos (hps, flOptions, ICount, pchString, alXincrements, 

aptl Positions) 


HPS 

ULONG 

LONG 

PCH 

PLONG 

PPOINTL 


hps; 

flOptions; 
ICount; 
pchString; 
alXincrements; 
aptl Positions; 


/ic Presentation-space handle */ 

lie Option flag */ 

lie Length of the string */ 

lit The character string to be examined */ 

/ic Vector of x increment values */ 

lie Array of points */ 


BOOL fSuccess; 


/* Success indicator */ 
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GpiQueryCharStringPosAt 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryCharStringPosAt (hps, pptlStart, flOptions, ICount, pchString, 

alXincrements, apt! Positions) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptlStart; /* Starting position */ 

ULONG fl Options; /* Option flags */ 

LONG 1 Count; /* Length of the string ie/ 

PCH pchString; /* Character string to be examined */ 

PLONG alXincrements; /ie Vector of x increment values ie! 

PPOINTL aptl Positions; /ie Array of points, in which the positions of each character in 

world coordinates are returned */ 

BOOL fSuccess; /ie Success indicator ie/ 


GpiQueryClipBox 

^define INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM ie/ 

LONG 1 Complexity = GpiQueryClipBox (hps, prcl Bound) 

HPS hps; /ie Presentation-space handle */ 

PRECTL prcl Bound; /ie Bounding rectangle */ 

LONG 1 Complexity; /* Complexity/error indicator */ 


GpiQueryClipRegion 

#define INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM ie/ 
HRGN hrgn = GpiQueryClipRegion (hps) 

HPS hps; /ie Presentation-space handle */ 

HRGN hrgn; /* Clip-region handle (if any) */ 


GpiQueryColor 

^define INCLJiPIPRIMITIVES /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 
LONG 1 Col or = GpiQueryColor (hps) 

HPS hps; /ie Presentation-space handle */ 

LONG 1 Col or; /* Color attribute ie/ 


GpiQueryColorData 

#define I NC L_G P I LOGCO LO RTAB L E /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryColorData (hps, 1 Count, al Array) 

HPS hps; /ie Presentation-space handle ie/ 

LONG 1 Count; /* Number of elements */ 

PLONG al Array; /* Array */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryColorlndex 

#define INCL_GPILOGCOLORTABLE /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Index = GpiQueryColorlndex (hps, fl Options, lRgbColor) 

HPS hps; /ie Presentation-space handle */ 

ULONG fl Options; /ie Options ie/ 

LONG lRgbColor; /* Specifies a color in RGB terms */ 

LONG 1 Index; /* Color index providing closest match to the specified color */ 
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GpiQueryCp 

#define INCL_GPILCIDS /* Or use INCL_GPI or INCL_PM */ 
USHORT usCodePage = GpiQueryCp (hps) 

HPS hps; /* Presentation-space handle */ 

USHORT usCodePage; /* Code page */ 


GpiQueryCurrentPosition 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryCurrentPosition (hps, pptlPoint) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptlPoint; /* Current position */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryDefArcParams 

#def i ne INCL_GPIDEFAULTS /* Or use INCL.GPI or INCL.PM */ 

BOOL fSuccess = GpiQueryDefArcParams (hps, parcpArcParams) 

HPS hps; /* Presentation-space handle */ 

PARC P ARAMS parcpArcParams; /* Default arc parameters */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryDefAttrs 

#define I NCLJ5PI DEFAULTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess « GpiQueryDefAttrs (hps, IPrimType, flAttrMask, ppbunAttrs) 

HPS hps; /* Presentation-space handle */ 

LONG IPrimType; /* Primitive type */ 

ULONG flAttrMask; /* Attributes mask */ 

PBUNDLE ppbunAttrs; /* Attributes */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryDefauItViewMatrix 

^define INCL_GPITRANSFORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryDefauItViewMatrix (hps, 1 Count, pmatlf Array) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Count; /* Number of elements */ 

PMATRIXLF pmatlf Array; /* Transform matrix */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryDefCharBox 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiQueryDefCharBox (hps, psizlSize) 

HPS hps; /* Presentation-space handle */ 

PSIZEL psizlSize; /* Default character-box size */ 

BOOL fSuccess; /* Success indicator */ 
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GpiQueryDefTag 

#define INCL_GPIDEFAULTS /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQueryDefTag (hps, pi Tag) 

HPS hps; /* Presentation-space handle */ 

PLONG pi Tag; /* Default tag identifier */ 

BOOL f Success; /* Success indicator */ 

GpiQueryDefViewingLimits 

#define INCL_GPIDEFAULTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryDefViewingLimits (hps, prcl Limits) 

HPS hps; /* Presentation-space handle */ 

PRECTL prclLimits; /* Default viewing limits */ 

BOOL fSuccess; /* Success indicator */ 

Gpi Query Device 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 
HDC hdc = GpiQueryDevice (hps) 

HPS hps; /* Presentation-space handle */ 

HDC hdc; /* Device-context handle */ 

GpiQueryDeviceBitmapFormats 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiQueryDeviceBitmapFormats (hps, 1 Count, al Array) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Count; /* Number of elements */ 

PLONG al Array; /* Data array */ 

BOOL fSuccess; /* Success indicator */ 

GpiQueryDrawControl 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM */ 

LONG lValue = GpiQueryDrawControl (hps, IControl) 

HPS hps; /* Presentation-space handle */ 

LONG IControl; /* Control whose value is to be returned */ 

LONG 1 Value; /* Value of the control */ 

GpiQueryDrawingMode 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM */ 

LONG IMode = GpiQueryDrawingMode (hps) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Drawing mode */ 

GpiQueryEditMode 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

LONG IMode = GpiQueryEditMode (hps) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Current editing mode */ 
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GpiQueryElement 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

LONG IRetLength = GpiQueryElement (hps, lOff, IMaxLength, pbData) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Off; /* Starting byte offset within the element */ 

LONG IMaxLength; /* Maximum length of data that can be returned */ 

PBYTE pbData; /* Element content data */ 

LONG IRetLength; /* Number of bytes returned */ 


GpiQueryElementPointer 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 
LONG 1 Element = GpiQueryElementPointer (hps) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Element; /* Current element pointer */ 


GpiQueryElementType 

#def i ne INCL_GPISEGEDITING /* Or use INCL_GPI or INCL.PM */ 

LONG IReqLength = GpiQueryElementType (hps, pi Type, 1 Length, pszData) 

HPS hps; /* Presentation-space handle */ 

PLONG pi Type; /* Element type */ 

LONG 1 Length; /* Data length */ 

PSZ pszData; /* Description of data buffer */ 

LONG IReqLength; /* Size of the data required to hold the element content */ 


GpiQueryFontFileDescriptions 

^define INCL_GPI LCIDS /* Or use INCLGPI or INCL_PM */ 

LONG IRemFonts = GpiQueryFontFileDescriptions (hab, pszFilename, pi Count, affdescsNames) 

HAB hab; /* Anchor-block handle */ 

PSZ pszFilename; /* Fully qualified filename */ 

PLONG plCount; /* Maximum number of family and facename pairs to be returned */ 

PFFDESCS affdescsNames; /* Array of font file descriptors */ 

LONG IRemFonts; /* Returns */ 


GpiQueryFontMetrics 

^define INCL_GPI LCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQueryFontMetrics (hps, IMetricsLength, pfmMetrics) 

HPS hps; /* Presentation-space handle */ 

LONG IMetricsLength; /* Length of metrics */ 

PFONTMETRICS pfmMetrics; /* Metrics of font */ 

BOOL f Success; /* Success indicator */ 
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GpiQueryFonts 

#define INCL_GPILCIDS /* Or use INCLGPI or INCL_PM */ 


LONG IRemFonts = GpiQueryFonts (hps, fl Opt ions, pszFacename, plReqFonts, 

IMetricsLength, afmMetrics) 


HPS 

ULONG 

PSZ 

PLONG 

LONG 

PFONTMETRICS 


hps; 

fl Options; 

pszFacename; 

plReqFonts; 

IMetricsLength; 

afmMetrics; 


/* Presentation-space handle */ 
/* Enumeration options */ 

/* Facename of fonts */ 

/* Count of fonts */ 

/* Length of metrics */ 

/* Metrics of font */ 


LONG 


IRemFonts; /* Count of fonts not returned */ 


GpiQueryGraphicsField 

fdefine I NC L_GP ITRANS FORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryGraphicsField (hps, prcl Field) 

HPS hps; /is Presentation-space handle */ 

PRECTL prcl Field; /* Graphics field is/ 

BOOL fSuccess; /* Success indicator */ 


GpiQuerylnitialSegmentAttrs 

#define I NCL_GP I SEGMENTS /* Or use INCL.GPI or INCL.PM is/ 

LONG IValue = GpiQuerylnitialSegmentAttrs (hps, 1 Attribute) 

HPS hps; /is Presentation-space handle is/ 

LONG 1 Attribute; /is Attribute to be queried */ 

LONG IValue; /* Current initial attribute value */ 


GpiQueryKerningPairs 

#define INCL_GPI LCIDS /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Returned = GpiQueryKerningPairs (hps, 1 Count, akrnprData) 


HPS 

LONG 

PKERNINGPAIRS 


hps; /is Presentation-space handle */ 

1 Count; /* The number of elements in Data */ 

akrnprData; /* Kerning pairs is/ 


LONG 


1 Returned; /* Number returned/error indicator */ 


GpiQueryLineEnd 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 
LONG ILineEnd = GpiQueryLineEnd (hps) 

HPS hps; /* Presentation-space handle */ 

LONG ILineEnd; /* Line end */ 


GpiQueryLineJoin 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 
LONG ILineJoin = GpiQueryLineJoin (hps) 

HPS hps; /is Presentation-space handle is/ 

LONG ILineJoin; /* Line join */ 
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GpiQueryLineType 

#define INCL_GPIPRIMITIVES /* Or use INCL^GPI or INCL_PM */ 

LONG 1 LineType a GpiQueryLineType (hps) 

HPS hps; /* Presentation-space handle */ 

LONG 1 LineType; /* Line type */ 

GpiQueryLineWidth 

#define INCLJ5PIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

FIXED fxLineWidth = GpiQueryLineWidth (hps) 

HPS hps; /* Presentation-space handle */ 

FIXED fxLineWidth; /* Line width */ 

GpiQueryLineWidthGeom 

#define INCL_GPIPRIMITI VES /* Or use INCLJ3PI or INCL_PM */ 

LONG ILineWidth = GpiQueryLineWidthGeom (hps) 

HPS hps; /* Presentation-space handle */ 

LONG ILineWidth; /* Geometric line width */ 

GpiQueryLogColorTable 

#define INCL_GPILOGCOLORTABLE /* Or use INCL_GPI or INCL.PM */ 

LONG IRetCount = GpiQueryLogColorTable (hps, fl Opt ions, 1 Start, 1 Count, al Array) 

HPS hps; fie Presentation-space handle it/ 

ULONG fl Options; /* Specifies options it/ 

LONG 1 Start; /it The starting index for which data is to be returned it/ 

LONG 1 Count; /it Count of elements it/ 

PLONG al Array; /* An array in which the information is returned */ 

LONG IRetCount; /* Number of elements returned/error indicator */ 

GpiQueryMarker 

#defi ne INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL.PM it/ 

LONG 1 Symbol = GpiQueryMarker (hps) 

HPS hps; /it Presentation-space handle */ 

LONG 1 Symbol; /* Marker symbol */ 

GpiQueryMarkerBox 

^define INCL_GPIPRIMITIVE$ /* Or use INCL_GPI or INCL_PM ie/ 

BOOL fSuccess = GpiQueryMarkerBox (hps, psizfxSize) 

HPS hps; /it Presentation-space handle */ 

PSIZEF psizfxSize; /it Size of marker box ie/ 

BOOL fSuccess; /* Success indicator */ 

GpiQueryMarkerSet 

#define INCL_GPIPRIMITIVES /it Or use INCL_GPI or INCL.PM it/ 

LONG lSet = GpiQueryMarkerSet (hps) 

HPS hps; /ie Presentation-space handle it/ 

LONG lSet; /* Marker set local identifier */ 
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GpiQueryMetaFileBits 

fdefine INCL.GPIMETAFILES /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQueryMetaFileBits (hmf, 1 Offset, 1 Length, pbData) 

HMF hmf ; /* Memory-metafile handle */ 

LONG 1 Offset; /* Byte offset */ 

LONG 1 Length; /* Length in bytes of the metafile data to copy */ 

PBYTE pbData; /* Metafile data */ 

BOOL f Success; /* Success indicator */ 

GpiQueryMetaFileLength 

fdefine INCL_GPIMETAFILES /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Length = GpiQueryMetaFileLength (hmf) 

HMF hmf; /* Memory-metafile handle */ 

LONG 1 Length; /* Total length of the metafile */ 

GpiQueryMix 

fdefine INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

LONG IMixMode = GpiQueryMix (hps) 

HPS hps; /* Presentation-space handle */ 

LONG IMixMode; /* Mix mode */ 

GpiQueryModelTransformMatrix 

fdefine INCL.GPITRANSFORMS /* Or use INCL.GPI or INCL_PM */ 

BOOL f Success a GpiQueryModelTransformMatrix (hps, 1 Count, pmatlf Array) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Count; /* Number of elements */ 

PMATRIXLF pmatlfArray; /* Transform matrix */ 

BOOL f Success; /* Success indicator */ 

GpiQueryNearestColor 

#define INCLJ5PI LOGCOLORTABLE /* Or use INCL_GPI or INCL_PM */ 

LONG lRgbOut = GpiQueryNearestColor (hps, fl Opt ions, lRgbln) 

HPS hps; /* Presentation-space handle */ 

ULONG fl Options; /* Options */ 

LONG lRgbln; /* Required color */ 

LONG lRgbOut; /* Nearest available color to the one specified */ 

GpiQueryNumberSetlds 

#define INCLGPILCIDS /* Or use INCLJ3PI or INCL.PM */ 

LONG 1 Count = GpiQueryNumberSetlds (hps) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /* Number of lcids */ 


4-24 PM C/2 Bindings Reference 



GpiQueryPageViewport 

#define I NCL_GPI TRANS FORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQueryPageViewport (hps, prcl Viewport) 

HPS hps; /* Presentation-space handle */ 

PRECTL prcl Viewport; /* Page viewport */ 

BOOL f Success; /* Success indicator */ 

GpiQueryPattern 

^define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 
LONG 1 PatternSymbol = GpiQueryPattern (hps) 

HPS hps; /* Presentation-space handle */ 

LONG 1 PatternSymbol ; /* Pattern symbol */ 

GpiQueryPatternRefPoint 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiQueryPatternRefPoint (hps, pptlRefPoint) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptlRefPoint; /* Pattern reference point */ 

BOOL fSuccess; /* Success indicator */ 

GpiQueryPatternSet 

^define INCL_GPIPRIMITIVES /* Or use INCLJ3PI or INCL_PM */ 

LONG lSet = GpiQueryPatternSet (hps) 

HPS hps; /* Presentation-space handle */ 

LONG lSet; /* Pattern-set local identifier */ 

GpiQueryPel 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Col or = GpiQueryPel (hps, pptl Point) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptl Point; /* Position in world coordinates */ 

LONG 1 Col or; /* Color index of the pel */ 

GpiQueryPickAperturePosition 

#define INCL_GPICORRELATION /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryPickAperturePosition (hps, pptl Point) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptl Point; /it Pick aperture position */ 

BOOL fSuccess; /* Success indicator */ 

GpiQueryPickApertureSize 

#define I NCL_G PI COR RELATION /it Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryPickApertureSize (hps, psizlSize) 

HPS hps; /it Presentation-space handle */ 

PSIZEL psizlSize; /* Pick aperture size it/ 

BOOL fSuccess; /it Success indicator */ 
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GpiQueryPS 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM */ 

ULONG fl Options = GpiQueryPS (hps, psizlSize) 

HPS hps; /* Presentation-space handle */ 

PSI2EL psizlSize; /* Presentation-page size */ 

ULONG fl Options; /* Presentation-space options */ 


GpiQueryRealColors 

#define I NC L_GP I LOGCO LO RTAB L E /* Or use INCL_GPI or INCLPM */ 

LONG IRetCount s GpiQueryRealColors (hps, fl Options, 1 Start, 1 Count, al Colors) 

HPS hps; /* Presentation-space handle */ 

ULONG fl Options; /* Options */ 

LONG IStart; /* Ordinal number of the first color required */ 

LONG 1 Count; /* Maximum number of elements */ 

PLONG al Colors; /* Array in which the information is returned */ 

LONG IRetCount; /* Number of elements returned */ 


GpiQueryRegionBox 

#define INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Complexity = GpiQueryRegionBox (hps, hrgn, prcl Bound) 

HPS hps; /* Presentation-space handle */ 

HRGN hrgn; /* Region handle */ 

PRECTL prcl Bound; /* Bounding rectangle */ 

LONG 1 Complexity; /* Complexity of region/error indicator */ 


GpiQueryRegionRects 

#define INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryRegionRects (hps, hrgn, prclBound, prgnrcControl , arclRects) 


HPS 

HRGN 

PRECTL 

PRGNRECT 

PRECTL 


hps; 

hrgn; 

prclBound; 
prgnrcControl ; 
arclRects; 


/* Presentation-space handle */ 

/* Region handle */ 

/* Bounding rectangle */ 

/* Processing-control structure */ 

/* Array of rectangle structures, in which the rectangles are 
returned */ 


BOOL fSuccess; 


/* Success indicator */ 


GpiQueryRGBColor 

#define INCL_GPILOGCOLORTABLE /* Or use INCL_GPI or INCL_PM */ 

LONG lRgbColor = GpiQueryRGBColor (hps, flOptions, IColorIndex) 

HPS hps; /* Presentation-space handle */ 

ULONG flOptions; /* Options */ 

LONG IColorIndex; /* Color index */ 

LONG lRgbColor; /* RGB color providing closest match to the specified color index */ 
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GpiQuerySegmentAttrs 

#define INCL_GPISE6MENTS /* Or use INCL_GPI or INCL_PM */ 

LONG lValue = GpiQuerySegmentAttrs (hps, lSegid, 1 Attribute) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Segid ; /* Segment identifier; must be greater than 0 */ 

LONG 1 Attribute; /* Attribute to be queried */ 

LONG 1 Value; /* Current attribute value */ 


GpiQuerySegmentNames 

#def i ne I NCL_GPI SEGMENTS /* Or use INCLJ5PI or INCL_PM */ 

LONG IRetCount = GpiQuerySegmentNames (hps, lFirstSegid, ILastSegid, IMax, alSegids) 
HPS hps; /* Presentation-space handle */ 

LONG lFirstSegid; /* First segment in the range; must be greater than 0 */ 

LONG ILastSegid; /* Last segment in the range; must be greater than 0 */ 

LONG IMax; /* Maximum number */ 

PLONG alSegids; /* Array in which the required identifiers are returned */ 

LONG IRetCount; /* Number of identifiers returned */ 


GpiQuerySegmentPriority 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL_PM */ 

LONG lSegid = GpiQuerySegmentPriority (hps, IRefSegid, 1 Order) 

HPS hps; /* Presentation-space handle */ 

LONG IRefSegid; /* Reference segment identifier */ 

LONG 1 Order; /* Segment higher or lower */ 

LONG lSegid; /* Segment identifier */ 


GpiQuerySegmentTransform Matrix 

^define I NC L_G P I TRAN S FO RMS /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success ° GpiQuerySegmentTransformMatrix (hps, lSegid, 1 Count, pmatlfArray) 

HPS hps; /* Presentation-space handle */ 

LONG lSegid; /* Segment identifier */ 

LONG 1 Count; /* Number of elements */ 

PMATRIXLF pmatlfArray; /* Transform matrix */ 

BOOL f Success; /* Success indicator */ 


GpiQuerySetlds 

#def i ne INCL_GPILCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiQuerySetlds (hps, 1 Count, al Types, aNames, allcids) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Count; /* The number of objects to be queried */ 

PLONG al Types; /* Object types */ 

PSTR8 aNames; /* Font names */ 

PLONG allcids; /* Local identifiers */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryStopDraw 

#def i ne INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM */ 

LONG lValue = GpiQueryStopDraw (hps) 

HPS hps; /* Presentation-space handle */ 

LONG lValue; /* Stop draw condition indicator */ 
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GpiQueryTag 

Idefine INCLJ3PI CORRELATION /* Or use INCL_GPI or INCLJ>M */ 

BOOL fSuccess = GpiQueryTag (hps, pi Tag) 

UPS hps; /* Presentation-space handle */ 

PLONG plTag; /* Tag identifier */ 

BOOL fSuccess; /* Success indicator */ 


GpiQueryTextBox 

^define INCLJ5PIPRIMITIVES /* Or use INCLJ5PI or INCL_PM */ 

BOOL fSuccess = GpiQueryTextBox (hps, lCountl, pchString, 10ount2, aptlPoints) 


HPS 

LONG 

PCH 

LONG 

PPOINTL 


hps; 

lCountl; 
pchStri ng; 
lCount2; 
aptlPoints; 


/* Presentation-space handle */ 
/* Number of characters */ 

/* The character string */ 

/* Number of points */ 

/* List of points */ 


BOOL fSuccess; /* Success indicator */ 


GpiQueryViewingLimits 

#define INCLJ3PITRANSF0RMS /* Or use INCLJ5PI or INCL_PM */ 

BOOL fSuccess = GpiQueryViewingLimits (hps, prcl Limits) 

HPS hps; /* Presentation-space handle */ 

PRECTL prcl Limits; lie Viewing limits iel 

BOOL fSuccess; lie Success indicator */ 


GpiQueryViewingTransformMatrix 

#define INCL_GPITRANSFORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryViewingTransformMatrix (hps, 1 Count, pmat If Array) 


HPS 

LONG 

PMATRIXLF 


hps; lie Presentation-space handle iel 

1 Count; lie Number of elements */ 
pmatlf Array; /* Transform matrix iel 


BOOL 


fSuccess; /* Success indicator */ 


GpiQueryWidthTable 

^define INCL.GPILCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiQueryWidthTable (hps, lFirstChar, 1 Count, alData) 

HPS hps; lie Presentation-space handle */ 

LONG lFirstChar; /* Codepoint of first character */ 

LONG 1 Count; /* Count of elements in Data iel 

PLONG alData; /* Array of width values iel 

BOOL fSuccess; /ie Success indicator */ 


GpiRealizeColorTable 

^define INCL_GPILOGCOLORTABLE /* Or use INCL_GPI or INCL.PM iel 
BOOL fSuccess = GpiRealizeColorTable (hps) 

HPS hps; lie Presentation-space handle */ 

BOOL fSuccess; lie Success indicator */ 


4-28 PM C/2 Bindings Reference 



GpiRectlnRegion 

#define INCL_GPIREGIONS /* Or use INCL_GPI or INCL_PM */ 

LONG 1 Inside = GpiRectlnRegion (hps, hrgn, prclRect) 

HPS hps; /* Presentation-space handle */ 

HRGN hrgn; /* Region handle */ 

PRECTL prclRect; /* Test rectangle */ 

LONG 1 Inside; /* Inside/error indicator */ 


GpiRectVisible 

#define INCLJ2PI PRIMITIVES /it Or use INCL_GPI or INCL_PM */ 

LONG 1 Visibility = GpiRectVisible (hps, prcl Rectangle) 

HPS hps; /it Presentation-space handle */ 

PRECTL prcl Rectangle; /* Test rectangle, in world coordinates */ 

LONG lVisibility; /* Visibility indicator it/ 


GpiRemoveDynamics 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiRemoveDynamics (hps, lFirstSegid, lLastSegid) 

HPS hps; /it Presentation-space handle */ 

LONG lFirstSegid; /it First segment in the section it/ 

LONG lLastSegid; /* Last segment in the section */ 

BOOL fSuccess; /it Success indicator */ 


GpiResetBoundaryData 

#define INCL_GPICORRELATION /it Or use INCL_GPI or INCL.PM it/ 
BOOL fSuccess ° GpiResetBoundaryData (hps) 

HPS hps; /it Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiResetPS 

#define I NCL_G PI CONTROL /* Or use INCL_GPI or INCL_PM it/ 

BOOL fSuccess = GpiResetPS (hps, fl Options) 

HPS hps; /it Presentation-space handle it/ 

ULONG fl Options; /* Reset option */ 

BOOL fSuccess; /it Success indicator */ 


GpiRestorePS 

#define INCL_GPICONTROL /it Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = GpiRestorePS (hps, IPSid) 

HPS hps; /it Presentation-space handle it/ 

LONG IPSid; /it Identifier of the saved presentation space that is to be restored it/ 

BOOL fSuccess; /it Success indicator */ 
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Gpi Rotate 

#defi ne I NCL_GP I TRANSFORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = Gpi Rotate (hps, pmatlfArray, 1 Options, fxAngle, pptl Center) 

HPS hps; /* Presentation-space handle */ 

PMATRIXLF pmatlfArray; /* Transform matrix */ 

LONG 1 Options; /* Transform options */ 

FIXED fxAngle; /* Rotation angle it/ 

PPOINTL pptl Center; /* Center of rotation it/ 

BOOL fSuccess; /* Success indicator it/ 


GpiSaveMetaFile 

^define INCL_GPIMETAFILES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSaveMetaFile (hmf, pszFilename) 

HMF hmf; /* Metafile handle */ 

PSZ pszFilename; /* Filename */ 

BOOL fSuccess; /* Success indicator */ 

GpiSavePS 

#define INCL_GPICONTROL /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 
LONG IPSid = GpiSavePS (hps) 

HPS hps; /it Presentation-space handle */ 

LONG IPSid; fit Identifier of saved presentation space */ 


GpiScale 

#define INCL_GPITRANSFORMS /a Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiScale (hps, pmatlfArray, 1 Options, afxScale, pptl Center) 

HPS hps; /it Presentation-space handle it/ 

PMATRIXLF pmatlfArray; /* Transform matrix */ 

LONG 1 Options; /* Transform options */ 

PFIXED afxScale; /* Scale factors */ 

PPOINTL pptl Center; /* Center of scale it/ 

BOOL fSuccess; /* Success indicator it/ 


GpiSetArcParams 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL^PM */ 

BOOL fSuccess = GpiSetArcParams (hps, parcpArcParams) 

HPS hps; /it Presentation-space handle */ 

PARCPARAMS parcpArcParams; /* Arc parameters it/ 

BOOL fSuccess; /* Success indicator */ 


GpiSetAttrMode 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiSetAttrMode (hps, IMode) 

HPS hps; /it Presentation-space handle */ 

LONG IMode; /it Attribute mode */ 

BOOL fSuccess; /* Success indicator it/ 
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GpiSetAttrs 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL f Success = GpiSetAttrs (hps, lPrimType, flAttrMask, flDefMask, ppbunAttrs) 

HPS hps; /* Presentation-space handle */ 

LONG lPrimType; /* Primitive type */ 

ULONG flAttrMask; /* Attributes mask */ 

ULONG flDefMask; /* Defaults mask */ 

PBUNDLE ppbunAttrs; /* Attributes */ 

BOOL f Success; /* Success indicator */ 


GpiSetBackColor 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetBackColor (hps, 1 Col or) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Col or; /* Background color */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetBackMix 

#define INCLGPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetBackMix (hps, IMixMode) 

HPS hps; /* Presentation-space handle */ 

LONG IMixMode; /* Background-mix mode */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetBitmap 

Idefine INCLGPIBITMAPS /* Or use INCLGPI or INCL_PM. Also in COMMON section */ 

HBITMAP hbmOld = GpiSetBitmap (hps, hbm) 

HPS hps; /* Presentation-space handle */ 

HBITMAP hbm; /* Handle of the bit map to be set */ 

HBITMAP hbmOld; /* Old bit-map handle */ 


GpiSetBitmapBits 

#defi ne INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

LONG IScansSet = GpiSetBitmapBits (hps, IScanStart, 1 Scans, pbBuffer, pbmi InfoTable) 

HPS hps; /* Presentation-space handle */ 

LONG IScanStart; /* Line number */ 

LONG 1 Scans; /* Number of scan lines to be transmitted */ 

PBYTE pbBuffer; /* Bit-map data buffer */ 

PBITMAPINFO pbmi InfoTable; /* Bit-map information table */ 

LONG IScansSet; /* Number of scan lines actually set */ 


GpiSetBitmapDimension 

^define INCLJ5PIBITMAPS /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiSetBitmapDimension (hbm, psizlBitmapDimension) 

HBITMAP hbm; /* Bit-map handle */ 

PSIZEL psizlBitmapDimension; /* Width and height of bit map */ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetBitmapId 

Idefine INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetBitmapId (hps, hbm, ILcid) 

HPS hps; /* Presentation-space handle */ 

HBITMAP hbm; /* Bit-map handle */ 

LONG ILcid; /* Local identifier with which the bit map is to be tagged */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetCharAngle 

Idefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetCharAngle (hps, pgradl Angle) 

HPS hps; /* Presentation-space handle */ 

PGRADIENTL pgradlAngle; /* Baseline angle */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetCharBox 

#define INCL_GPIPRIMITIVES /* Or use INCLGPI or INCL_PM */ 

BOOL fSuccess 3 GpiSetCharBox (hps, psizfxBox) 

HPS hps; /* Presentation-space handle */ 

PSIZEF psizfxBox; /* Character-box size in world coordinates */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetCharDirection 

#define INCLJaPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetCharDirection (hps, 1 Direction) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Direction; /* Character direction */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetCharMode 

Idefine INCL_GPIPRIMITIVES /* Or use INCLJ5PI or INCL_PM */ 

BOOL fSuccess 3 GpiSetCharMode (hps, IMode) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Character mode */ 

BOOL fSuccess; /* Success indicator */ 

GpiSetCharSet 

Idefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetCharSet (hps, llcid) 

HPS hps; /* Presentation-space handle */ 

LONG llcid; /* Character-set local identifier */ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetCharShear 

Idefine INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetCharShear (hps, pptl Angle) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptl Angle; /* Character shear vector */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetClipPath 

fdefine INCL_GPIPATHS /* Or use INCL.GPI or INCL_PM */ 

BOOL fSuccess = GpiSetClipPath (hps, IPath, lOptions) 

HPS hps; /* Presentation-space handle */ 

LONG IPath; /* Path control flag */ 

LONG lOptions; /* Options */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetClipRegion 

Idefine INCL_GPIREGIONS /* Or use INCL_6PI or INCL_PM */ 

LONG 1 Complexity = GpiSetClipRegion (hps, hrgn, phrgnOld) 

HPS hps; /* Presentation-space handle */ 

HRGN hrgn; /* Region handle */ 

PHRGN phrgnOld; /* Old region handle (if any) */ 

LONG 1 Complexity; /* Complexity of clipping/error indicator */ 


GpiSetColor 

#define INCL^GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = GpiSetColor (hps, 1 Col or) 

HPS hps; /it Presentation-space handle it/ 

LONG 1 Col or; /* Color it/ 

BOOL fSuccess; /it Success indicator */ 


GpiSetCp 

#def i ne INCL.GPILCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetCp (hps, usCodePage) 

HPS hps; /it Presentation-space handle */ 

USHORT usCodePage; /* Code-page id */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetCurrentPosition 

Idefine INCLJ5PI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetCurrentPosition (hps, pptl Point) 

HPS hps; /it Presentation-space handle */ 

PPOINTL pptl Point; /* New value of current position it/ 

BOOL fSuccess; /it Success indicator */ 
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GpiSetDefArcParams 

#define I NCL_GPI DEFAULTS /* Or use INCLJ5PI or INCL_PM */ 

BOOL fSuccess = GpiSetDefArcParams (hps, parcpArcParams) 

HPS hps; /* Presentation-space handle */ 

PARCPARAMS parcpArcParams; /* Default arc parameters */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetDefAttrs 

fdefine I NCL_GP I DEFAULTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetDefAttrs (hps, IPrimType, flAttrMask, ppbunAttrs) 

HPS hps; /* Presentation-space handle */ 

LONG IPrimType; /* Primitive type */ 

ULONG flAttrMask; /* Attributes mask */ 

PBUNDLE ppbunAttrs; /* Default attribute values */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetDefauItViewMatrix 

#define INCL_GPITRANSFORMS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetDefauItViewMatrix (hps, ICount, pmatlfarray, lOptions) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /* Number of elements */ 

PMATRIXLF pmatlfarray; /* Transformation matrix it/ 

LONG lOptions; /* Transform options */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetDefTag 

#define INCL_GPIDEFAULTS /* Or use INCLJ5PI or INCL^PM it/ 

BOOL fSuccess = GpiSetDefTag (hps, ITag) 

HPS hps; /it Presentation-space handle */ 

LONG ITag; /* Default tag identifier */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetDefViewingLimits 

#define INCL_GPIDEFAULTS /it Or use INCL_GPI or INCL_PM it/ 

BOOL fSuccess = GpiSetDefViewingLimits (hps, prcl Limits) 

HPS hps; /* Presentation-space handle */ 

PRECTL prcl Limits; /* Default viewing limits it/ 

BOOL fSuccess; /* Success indicator */ 


GpiSetDrawControl 

#define INCL_GPICONTROL /it Or use INCL_GPI or INCL_PM it/ 

BOOL fSuccess = GpiSetDrawControl (hps, IControl, lValue) 

HPS hps; /* Presentation-space handle */ 

LONG IControl; /it Drawing control */ 

LONG lValue; /* Required value of the drawing control */ 
BOOL fSuccess; /it Success indicator */ 
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GpiSetDrawingMode 

#define INCL_6PIC0NTR0L /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetDrawingMode (hps * IMode) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Mode to be used for subsequent drawing calls */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetEditMode 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetEditMode (hps, IMode) 

HPS hps; /* Presentation-space handle */ 

LONG IMode; /* Edit mode */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetElementPointer 

^define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetElementPointer (hps, 1 Element) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Element; /* The element number required */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetElementPointerAtLabel 

#define INCL_GPISEGEDITING /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetElementPointerAtLabel (hps, 1 Label) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Label; /* Required label */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetGraphicsField 

#define INCL_GPITRANSFORMS /* Or use INCLJJPI or INCL_PM */ 

BOOL fSuccess = GpiSetGraphicsField (hps, prcl Field) 

HPS hps; /* Presentation-space handle */ 

PRECTL prcl Field; /* Graphics field */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetlnitiaiSegmentAttrs 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetlnitiaiSegmentAttrs (hps, 1 Attribute, 1 Value) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Attribute; /* Segment attribute */ 

LONG lValue; /* Attribute value */ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetLineEnd 

Idefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetLineEnd (hps, ILineEnd) 

HPS hps; /* Presentation-space handle */ 

LONG ILineEnd; /* Style of line end */ 

BOOL fSuccess; /* Success indicator */ 

GpiSetLineJoin 

Idefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetLineJoin (hps, ILineJoin) 

HPS hps; /* Presentation-space handle */ 

LONG ILineJoin; /* Style of line join */ 

BOOL fSuccess; /* Success indicator */ 

GpiSetLineType 

Idefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetLineType (hps, ILineType) 

HPS hps; /* Presentation-space handle */ 

LONG ILineType; /* Line types available */ 

BOOL fSuccess; /•* Success indicator */ 

GpiSetLineWidth 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetLineWidth (hps, fxLineWidth) 

HPS hps; /* Presentation-space handle */ 

FIXED fxLineWidth; /* Line-width multiplier */ 

BOOL fSuccess; /* Success indicator */ 

GpiSetLineWidthGeom 

fdefine INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetLineWidthGeom (hps, ILineWidth) 

HPS hps; /* Presentation-space handle */ 

LONG ILineWidth; /* Geometric line width */ 

BOOL fSuccess; /* Success indicator */ 

GpiSetMarker 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetMarker (hps, lSymbol) 

HPS hps; /* Presentation-space handle */ 

LONG 1 Symbol; /* Marker symbol */ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetMarkerBox 

#define INCL_GPIPRIMITIVES /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiSetMarkerBox (hps, psizfxSize) 

HPS hps; /* Presentation-space handle */ 

PSIZEF psizfxSize; /* Size of marker box */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetMarkerSet 

fdefine INCLJ3PIPRIMITIVES /* Or use INCL_GPI or INCL_PM ic/ 

BOOL fSuccess = GpiSetMarkerSet (hps, 1 Set) 

HPS hps; /* Presentation-space handle */ 

LONG lSet; /it Marker-set local identifier */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetMetaFileBits 

#define INCL_GPIMETAFILES /* Or use INCL_GPI or INCL_PM if/ 

BOOL fSuccess = GpiSetMetaFileBits (hmf, lOffset, ILength, pbBuffer) 

HMF hmf; /* Metafile-memory handle */ 

LONG 1 Offset; /if Offset */ 

LONG ILength; /it Length of the metafile data it/ 

PBYTE pbBuffer; /it Metafile data buffer it/ 

BOOL fSuccess; /* Success indicator it/ 


GpiSetMix 

#define INCL.GPI PRIMITIVES /it Or use INCLJ3PI or INCL_PM */ 

BOOL fSuccess = GpiSetMix (hps, IMixMode) 

HPS hps; /it Presentation-space handle */ 

LONG IMixMode; /* Mix mode it/ 

BOOL fSuccess; /* Success indicator */ 


GpiSetModelTransform Matrix 

#define INCL_GPITRANSFORMS /it Or use INCL_GPI or INCL_PM it/ 

BOOL fSuccess = GpiSetModelTransformMatrix (hps, ICount, pmatlfArray, lOptions) 

HPS hps; /* Presentation-space handle */ 

LONG ICount; /it Number of elements in matrix */ 

PMATRIXLF pmatlfArray; /* Transformation matrix */ 

LONG lOptions; /it Transform options */ 

BOOL fSuccess; /it Success indicator */ 


GpiSetPageViewport 

#define INCL_GPITRANSFORMS /* Or use INCL_GPI or INCL^PM */ 

BOOL fSuccess = GpiSetPageViewport (hps, prcl Viewport) 

HPS hps; /it Presentation-space handle */ 

PRECTL prcl Viewport; /it Page viewport */ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetPattern 

#define INCL^GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = GpiSetPattern (hps, 1 PatternSymbol ) 

HPS hps; /* Presentation-space handle */ 

LONG 1 PatternSymbol ; /* Pattern symbol */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetPatternRefPoint 

Idefine INCL.GPIPRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetPatternRefPoint (hps, pptl Ref Point) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptl Ref Point; /* Pattern reference point */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetPatternSet 

#define INCL_GPI PRIMITIVES /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetPatternSet (hps, lSet) 

HPS hps; /it Presentation-space handle */ 

LONG 1 Set ; /it Pattern-set local identifier it/ 

BOOL fSuccess; /* Success indicator */ 


GpiSetPel 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM */ 

LONG lHits = GpiSetPel (hps, pptl Point) 

HPS hps; /it Presentation-space handle */ 

PPOINTL pptl Point; /* Position in world coordinates */ 

LONG lHits; /it Correlation/error indicator */ 


GpiSetPickAperturePosition 

#define INCL_GPICORRELATION /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetPickAperturePosition (hps, pptl Pick) 

HPS hps; /* Presentation-space handle */ 

PPOINTL pptl Pick; /it Center of the pick aperture it/ 

BOOL fSuccess; /* Success indicator */ 


GpiSetPickApertureSize 

#define I NCL_GP I CORRELATION /* Or use INCLGPI or INCL_PM */ 

BOOL fSuccess - GpiSetPickApertureSize (hps, 1 Options, psizlSize) 

HPS hps; /it Presentation-space handle */ 

LONG 1 Options; /* Setting option */ 

PSIZEL psizlSize; /it Pick aperture size it/ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetPS 

#define INCL_GPICONTROL /* Or use INCL.GPI or INCL_PM */ 

BOOL fSuccess = GpiSetPS (hps, psizlsize, flOptions) 

HPS hps; /* Presentation-space handle */ 

PSIZEL psizlsize; /* Presentation-space size */ 

ULONG flOptions; /* Options */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetRegion 

#define INCL_GPIREGIONS /* Or use INCL.GPI or INCL_PM */ 

BOOL fSuccess = GpiSetRegion (hps, hrgn, 1 count, arcl Rectangles) 

HPS hps; /* Presentation-space handle */ 

HRGN hrgn; /* Region handle */ 

LONG 1 count; /* -Count of rectangles */ 

PRECTL arcl Rectangles; /* Array of rectangles */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetSegmentAttrs 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetSegmentAttrs (hps, ISegid, 1 Attribute, 1 Value) 

HPS hps; /* Presentation-space handle */ 

LONG ISegid; /* Segment identifier */ 

LONG 1 Attribute; /* Segment attribute */ 

LONG lValue; /* Attribute value */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetSegmentPriority 

#define INCL_GPISEGMENTS /* Or use INCL_GPI or INCL.PM */ 

BOOL fSuccess = GpiSetSegmentPriority (hps, ISegid, IRefSegid, 1 Order) 

HPS hps; /* Presentation-space handle */ 

LONG ISegid; /* Segment identifier */ 

LONG IRefSegid; /* Reference segment identifier */ 

LONG 1 Order; /* Segment higher or lower */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetSegmentT ransformMatrix 

fdefine I N C L_GP I TRAN S FORMS /* Or use INCL_GPI or INCLWI */ 

BOOL fSuccess = GpiSetSegmentTransformMatrix (hps, ISegid, ICount, pmatlfarray, 

1 Options) 

HPS hps; /* Presentation-space handle */ 

LONG ISegid; /* Segment identifier */ 

LONG ICount; /* Number of elements */ 

PMATRIXLF pmatlfarray; /* Transformation matrix */ 

LONG 1 Options; /* Transform options */ 

BOOL fSuccess; /* Success indicator */ 
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GpiSetStopDraw 

#defi ne INCLJ3P I CONTROL /* Or use INCLJ3PI or INCL_PM */ 

BOOL f Success = GpiSetStopDraw (bps, 1 Value) 

HPS hps; /* Presentation-space handle */ 

LONG IValue; /* Stop draw condition */ 

BOOL f Success; /* Success indicator */ 

GpiSetTag 

#define INCL_GPICORRELATION /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiSetTag (hps, ITag) 

HPS hps; /* Presentation-space handle */ 

LONG ITag; /* Tag identifier */ 

BOOL fSuccess; /* Success indicator */ 


GpiSetViewingLimits 

#define I NC L_GP I TRANSFORMS /* Or use INCL_GPI or INCL_PM it/ 

BOOL fSuccess = GpiSetViewingLimits (hps, prcl Limits) 

HPS hps; /it Presentation-space handle it/ 

PRECTL prcl Limits; /* Viewing limits in model space */ 

BOOL fSuccess; /it Success indicator */ 


GpiSetViewingT ransformMatrix 

#define I N C L_G P I TRAN S FORMS /* Or use INCLJ3PI or INCL_PM */ 

BOOL fSuccess = GpiSetViewingTransformMatrix (hps, ICount, pmatlfArray, lOptions) 


HPS 

LONG 

PMATRIXLF 

LONG 


hps; 

ICount; 

pmatlfArray; 

lOptions; 


/* Presentation-space handle */ 
/it Number of elements */ 

/* Transformation matrix */ 

/it Transform option it/ 


BOOL 


fSuccess; /it Success indicator it/ 


GpiStrokePath 

#define INCL_GPIPATHS /* Or use INCL_GPI or INCL_PM */ 

LONG lHits = GpiStrokePath (hps, IPath, f lOptions) 

HPS hps; /* Presentation-space handle it/ 

LONG IPath; /it Identifier of path to be stroked; it must be 1 it/ 

ULONG f lOptions; /* Stroke option */ 

LONG lHits; /* Correlation/error indicator it/ 


GpiTranslate 


#define 

INCL_GPITRANSFORMS 

/* Or use INCL_GPI or INCL_PM */ 

BOOL 

fSuccess - GpiTranslate (hps, pmatlfArray, lOptions, pptl Translation) 

HPS 

hps; 

/it Presentation-space handle */ 

PMATRIXLF pmatl f Array ; 

/it Transform matrix */ 

LONG 

lOptions; 

/it Transform options it/ 

PPOINTL 

pptlTranslation; 

/it Translation */ 

BOOL 

fSuccess; 

/it Success indicator it/ 
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GpiUnloadFonts 

^define INCL_GPI LCIDS /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiUnloadFonts (hab, pszFilename) 

HAB hab; /* Anchor-block handle */ 

PSZ pszFilename; /* Fully qualified file name of the font resource */ 
BOOL fSuccess; /* Success indicator */ 

GpiUnrealizeColorTable 

fdefine INCLGPILOGCOLORTABLE /* Or use INCL_GPI or INCL_PM */ 

BOOL fSuccess = GpiUnrealizeColorTable (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 


GpiWCBitBIt 

#define INCL_GPIBITMAPS /* Or use INCL_GPI or INCL_PM. Also in COMMON section */ 

LONG 1 Hits » GpiWCBitBIt (hpsTarget, hbmSource, ICount, aptlPoints, IRop, flOptions) 

HPS hpsTarget; /* Target presentation-space handle */ 

HBITMAP hbmSource; /* Source bit-map handle */ 

LONG ICount; /* Point count */ 

PPOINTL aptlPoints; /* Point array */ 

LONG IRop; /* Mixing function required */ 

ULONG flOptions; /* Options */ 

LONG lHits; /* Correlation/error indicator */ 
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Chapter 5. Picture Function Calls 


Piclchg 

^define INCL_PIC /* Or use INCL_PM */ 

BOOL fSuccess = Piclchg (hab, pszSourceFileName, pszDestinationFileName, 1 Type) 

HAB hab; /* Anchor-block handle */ 

PSZ pszSourceFileName; /* The name of the source file */ 

PSZ pszDestinationFileName; /* The name of the destination file */ 

LONG IType; /* Specifies the type of conversion */ 

BOOL fSuccess; /* Success indicator */ 


PicPrint 

#defi ne INCL_PIC 

BOOL fSuccess = 


/* Or use INCL_PM */ 

PicPrint (hab, pszFilename, IType, pszParams) 


HAB hab; /* Anchor-block handle */ 

PSZ pszFilename; /* Full path and filename of the source file */ 


LONG IType; 

PSZ pszParams; 


/* Type of source file */ 
lie Spooler parameters */ 


BOOL fSuccess; /if Success indicator */ 
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Chapter 6. Profile Function Calls 


PrfAddProgram 

#define INCL.WINPROGRAMLIST /* Or use INCL.WIN or INCL.PM */ 

HPROGRAM hprog = PrfAddProgram (hini, pprogdeDetai 1 s , hprogGroup) 

HINI hini; /* Initialization-file handle */ 

PPROGDETAILS pprogdeDetai 1 s ; /* Program details for the program to be added to the program 

list */ 

HPROGRAM hprogGroup; /* Handle of the group to which the program is to be added it/ 

HPROGRAM hprog; /* Program handle for the program added to the program list */ 


PrfChangeProgram 

#define INCL.WINPROGRAMLIST /it Or use INCL.WIN or INCL_PM */ 

BOOL fSuccess = PrfChangeProgram (hini, hprog, pDetails) 

HINI hini; /* Initialization-file handle it/ 

HPROGRAM hprog; /it Handle of the program whose information is to be changed it/ 

PPROGDETAILS pDetails; /it Program details */ 

BOOL fSuccess; /* Success indicator */ 


PrfCloseProfile 

#define INCL_WINSHELLDATA /* Or use INCL.WIN or INCL_PM */ 
BOOL fSuccess = PrfCloseProfile (hini) 

HINI hini; /it Initialization-file handle */ 

BOOL fSuccess; /it Success indicator it/ 


PrfCreateGroup 

#define INC L_W I N PROGRAM LIST /it Or use INCL_WIN or INCL.PM */ 

HPROGRAM hprogGroup = PrfCreateGroup (hini, pszTitle, chVisibility) 

HINI hini; /* Initialization-file handle it/ 

PSZ pszTitle; /* Title of the new group */ 

UCHAR chVisibility; /* Visibility control */ 

HPROGRAM hprogGroup; /* Group handle for the newly-created group */ 


PrfDestroyGroup 

^define INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCL.PM */ 

BOOL fSuccess = PrfDestroyGroup (hini, hprogGroup) 

HINI hini; /it Initialization-file handle it/ 

HPROGRAM hprogGroup; /it Group handle it/ 

BOOL fSuccess; /it Success indicator */ 


PrfOpenProfile 

#define INCL.WINSHELLDATA /it Or use INCL.WIN or INCL.PM it/ 

HINI hini s PrfOpenProfile (hab, pszFileName) 

HAB hab; /it Anchor-block handle */ 

PSZ pszFileName; /it User-profile file name it/ 

HINI hini; /* Initialization-file handle */ 
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PrfQueryDefinition 

Idefine INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCL_PM */ 

ULONG ulLength = PrfQueryDefinition (hini, hprog, pDetails, cchBufferMax) 

HINI hini; /* Initialization-file handle */ 

HPROGRAM hprog; /* Handle of the program whose details are to be returned */ 

PPROGDETAILS pDetails; /* Program details */ 

ULONG cchBufferMax; /* Maximum length in bytes */ 

ULONG ulLength; /* Length of returned data */ 


PrfQueryProfile 

#define INCL_WINSHELLDATA /* Or use INCLWIN or INCL_PM */ 

BOOL fSuccess = PrfQueryProfile (hab, pprfproProfile) 

HAB hab; /* Anchor-block handle */ 

PPRFPROFILE pprfproProfile; /* Profile names structure */ 

BOOL fSuccess; /* Success indicator */ 


PrfQueryProfileData 

^define INCL_WINSHELLDATA /* Or use INCLJJIN or INCL_PM */ 

BOOL fSuccess = PrfQueryProfileData (hini, pszApp, pszKey, pBuffer, pul Buf ferMax) 

HINI hini; /* Initialization-file handle */ 

PSZ pszApp; /* Application name ic / 

PSZ pszKey; /* Key name */ 

PVOID pBuffer; /* Value data */ 

PULONG pulBufferMax; /* Size of value data */ 

BOOL fSuccess; /* Success indicator */ 


Prf Query Prof ilelnt 

#define INCLJ/INSHELLDATA /* Or use INCL_WIN or INCL_PM */ 

SHORT sResult = PrfQueryProfilelnt (hini, pszApp, pszKey, sDefault) 

HINI hini; /* Initialization-file handle */ 

PSZ pszApp; /ic Application name */ 

PSZ pszKey; /* Key name if/ 

SHORT sDefault; /* Default value */ 

SHORT sResult; /it Key value specified in the intial ization file */ 


PrfQueryProfileSize 

#define INCL_WINSHELLDATA /* Or use INCL_WIN or INCL_PM it/ 

BOOL fSuccess = PrfQueryProfileSize (hini, pszApp, pszKey, pDataLen) 

HINI hini; /* Initialization-file handle */ 

PSZ pszApp; /it Application name it/ 

PSZ pszKey; /it Key name */ 

PULONG pDataLen; /* Data length */ 

BOOL fSuccess; /it Success indicator it/ 
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PrfQueryProfileString 

^define INCL_WINSHELLDATA /* Or use INCL_WIN or INCL_PM */ 

ULONG pul Length = PrfQueryProfileString (hini, pszApp, pszKey, pszDefault, pBuffer, 

cchBufferMax) 


HINI 

hini ; 

/* Initialization-file handle */ 

PSZ 

pszApp; 

/* Application name */ 

PSZ 

pszKey; 

/* Key name */ 

PSZ 

pszDefault; 

/it Default string */ 

PVOID 

pBuffer; 

/it Profile string */ 

ULONG 

cchBufferMax; 

/* Maximum string length */ 

ULONG 

pul Length; 

/it String length returned */ 


PrfQueryProgramCategory 

#define INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCL.PM */ 

PROGCATEGORY Category = PrfQueryProgramCategory (hini, pszExe) 

HINI hini; /* Initialization-file handle */ 

PSZ pszExe; /* Executable-file name */ 

PROGCATEGORY Category; /* Program category */ 


PrfQueryProgramHandle 

^define INCL_WINPROGRAMLIST /* Or use INCl_WIN or INCL_PM */ 

ULONG ulLength = PrfQueryProgramHandle (hini, pszExe, phprogArray, cchBufferMax, 

pul Count) 

HINI hini; /* Initialization-file handle */ 

PSZ pszExe; /* Executable-file name */ 

PHPROGARRAY phprogArray; /* Program handles */ 

ULONG cchBufferMax; /* Maximum number of program handles */ 

PULONG pul Count; /* Number of program handles returned */ 

ULONG ulLength; /* Number of bytes returned */ 


PrfQueryProgramTitles 

^define INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCL_PM */ 

ULONG ulLength = PrfQueryProgramTitles (hini, hprogGroup, pTitles, cchBufferMax, 

pul Count) 

HINI hini; /* Initialization-file handle */ 

HPROGRAM hprogGroup; /* Handle of the program or group whose information is to be 

returned */ 

PPROGTITLE pTitles; /* Program information buffer */ 

ULONG cchBufferMax; /* Buffer length */ 

PULONG pul Count; /* Number of structures returned */ 

ULONG ulLength; /* Length returned */ 


PrfRemoveProgram 

^define INCL.WINPROGRAMLIST /* Or use INCL.WIN or INCL_PM */ 

BOOL fSuccess = PrfRemoveProgram (hini, hprog) 

HINI hini; /* Initialization-file handle */ 

HPROGRAM hprog; /* Program handle */ 

BOOL fSuccess; /* Success indicator */ 
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PrfReset 

Idefine INCL_WINSHELLDATA /* Or use INCL_WIN or INCL_PM */ 

BOOL f Success = PrfReset (hab, pprfproProfile) 

HAB hab; /* Anchor-block handle */ 

PPRFPROFILE pprfproProfile; /* Profile-names structure */ 

BOOL f Success; /* Success indicator if/ 


PrfWriteProfileData 

^define INCL_WINSHELLDATA /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess - PrfWriteProfileData (hini, pszApp, pszKey, pData, cchDataLen) 


HINI 

PSZ 

PSZ 

PVOID 

ULONG 


hini; /* Initialization-file handle */ 

pszApp; /it Application name ic/ 

pszKey; /* Key name */ 

pData; /* Value data */ 

cchDataLen; /* Size of value data */ 


BOOL fSuccess; /* Success indicator */ 


PrfWriteProfileString 

#define INCL_WINSHELLDATA /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = PrfWriteProfileString (hini, pszApp, pszKey, pszData) 

HINI hini; /* Initialization-file handle */ 

PSZ pszApp; /it Application name */ 

PSZ pszKey; /* Key name */ 

PSZ pszData; /* Text string */ 

BOOL fSuccess; /* Success indicator */ 
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Chapter 7. Spooler Function Calls 


SpIQmAbort 

#define INCL_SPL /* Or use INCL_PM */ 

BOOL f Success s SpIQmAbort (hspl) 

HSPL hspl; /* Spooler handle */ 

BOOL f Success; /* Success indicator */ 

SpIQmClose 

#define INCL_SPL /* Or use INCL_PM */ 

BOOL f Success = SpIQmClose (hspl) 

HSPL hspl; /* Spooler handle */ 

BOOL f Success; /* Success indicator */ 

SpIQmEndDoc 

#define INCL_SPL /* Or use INCL_PM */ 

USHORT usJob = SpIQmEndDoc (hspl) 

HSPL hspl; /* Spooler handle */ 

USHORT usJob; /* Job identifier */ 

SpIQmOpen 

#define INCL_SPL /* Or use INCL_PM */ 

HSPL hspl = SpIQmOpen (pszToken, 1 Count, pqmdopData) 

PSZ pszToken; /* A token (nickname) that identifies spooler information */ 

LONG 1 Count; /* Number of items */ 

PQMOPENDATA pqmdopData; /* Open parameters */ 

HSPL hspl; /ie Spooler handle */ 

SpIQmStartDoc 

#define INCL_SPL /* Or use INCL_PM */ 

BOOL fSuccess = SpIQmStartDoc (hspl, pszDocName) 

HSPL hspl; /ie Spooler handle */ 

PSZ pszDocName; /* Document name */ 

BOOL fSuccess; /* Success indicator */ 

SpIQmWrite 

#define INCL^SPL tie Or use INCL_PM */ 

BOOL fSuccess = SpIQmWrite (hspl, ICount, pbData) 

HSPL hspl; /ie Spooler handle ie/ 

LONG ICount; lie Length in bytes */ 

PBYTE pbData; lie Buffer of data to be written to the spool file */ 

BOOL fSuccess; lie Success indicator */ 
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SpIQpInstall 

#define INCL_SPL /* Or use INCL_PM */ 

BOOL fSuccess = SpIQpInstall (hwnd) 

HWND hwnd; /* Window handle */ 

BOOL fSuccess; /* Success indicator */ 

SpIQpQueryDt 

#define INCL_SPL /* Or use INCL_PM */ 

BOOL fSuccess = SpIQpQueryDt (pi Count, aszDatatypes) 

PLONG pi Count; /* Maximum number of data types that can be returned */ 

PSZ ^ aszDatatypes; /* An array containing the data types supported */ 

BOOL fSuccess; /* Success indicator */ 
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Chapter 8. Video Function Calls 


VioAssociate 

#define INCL_AVI0 /* Or use INCL_PM */ 

USHORT usError = VioAssociate (hdc, hvps) 

HOC hdc; /* Device-context handle */ 

HVPS hvps; /* VIO presentation-space handle */ 

USHORT usError; /* Error indicator */ 


VioCreateLogFont 


#define 

INCLJWIO 

/it Or use INCL_PM */ 

USHORT 

usError = 

VioCreateLogFont (pfatattrs, llcid, pName, hvps) 

PFATTRS 

pfatattrs 

; /it Attributes of font it/ 

LONG 

llcid; 

/it Local identifier */ 

PSTR8 

pName; 

/it Logical -font name */ 

HVPS 

hvps; 

/ it VIO presentation-space handle */ 

USHORT 

usError; 

/* Error indicator it/ 


VioCreatePS 

#define INCLJWIO /* Or use INCL.PM it/ 

USHORT usError = VioCreatePS (phvps, sdepth, swidth, sFormat, sAttrs, hvpsReserved) 


PHVPS 

SHORT 

SHORT 

SHORT 

SHORT 

HVPS 


phvps; /it 
sdepth; /* 
swidth; /* 
sFormat; /* 
sAttrs ; /it 
hvpsReserved; /it 


VIO presentation-space handle */ 
Presentation-space depth */ 
Presentation-space width it/ 
Presentation-space format it/ 
Attribute bytes per character it/ 
Reserved (must be zero) */ 


USHORT usError; 


/it Error indicator it/ 


VioDeleteSetld 

#define INCLJWIO /it Or use INCL.PM it/ 

USHORT usError = VioDeleteSetld (llcid, hvps) 

LONG llcid; /it Local identifier it/ 

HVPS hvps; /* VIO presentation-space handle it/ 

USHORT usError; /* Error indicator */ 


VioDestroyPS 

^define INCL_AVI0 /* Or use INCL_PM it/ 

USHORT usError = VioDestroyPS (hvps) 

HVPS hvps; /it VIO presentation-space handle it/ 
USHORT usError; /* Error indicator */ 
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VioGetDeviceCellSize 

#define INCLJWIO /* Or use INCL_PM */ 

USHORT usError = VioGetDeviceCellSize (psHeight, psWidth, hvps) 

PSHORT psHeight; /* Current device cell height in pels */ 

PSHORT psWidth; /* Current device cell width in pels */ 

HVPS hvps; /* VIO presentation-space handle */ 

USHORT usError; /* Error indicator */ 

VioGetOrg 

#define INCL_AVI0 /* Or use INCL_PM */ 

USHORT usError s VioGetOrg (psRow, psColumn, hvps) 

PSHORT psRow; /* Row number */ 

PSHORT psColumn; /* Column number */ 

HVPS hvps; /* VIO presentation-space handle */ 

USHORT usError; /* Error indicator */ 

VioQueryFonts 

#define INCL_AVI0 /* Or use INCL_PM */ 

USHORT usError = VioQueryFonts (pIRemfonts, afmMetrics, 1 Metrics Length, pi Fonts, 

pszFacename, fl Options, hvps) 

PLONG plRemfonts; /* Number of fonts for which information is not returned */ 

PFONTMETRICS afmMetrics; /* Font metrics */ 

LONG IMetricsLength; /* The length of each metrics record to be returned */ 

PLONG pi Fonts; /* Number of fonts */ 

PSZ pszFacename; /* Facename of the fonts of interest */ 

ULONG fl Options; /* Enumeration options */ 

HVPS hvps; /* VIO presentation-space handle */ 

USHORT usError; /* Error indicator */ 

VioQuerySetlds 

#define INCLJWIO /* Or use INCL_PM */ 

USHORT usError = VioQuerySetlds (allcids, pNames, al Types, 1 count, hvps) 

PLONG allcids; /* Local identifiers */ 

PSTR8 pNames; /* Font names */ 

PLONG al Types; /* Object types */ 

LONG 1 count; /* The number of objects to be queried */ 

HVPS hvps; /* VIO presentation-space handle */ 

USHORT usError; /* Error indicator */ 

VioSetDeviceCellSize 

#define INCL_AVI0 /* Or use INCL_PM */ 

USHORT usError = VioSetDeviceCellSize (sHeight, sWidth, hvps) 

SHORT sHeight; /* The required device cell height in pels */ 

SHORT sWidth; /* The required device cell width in pels */ 

HVPS hvps; /* VIO presentation space handle */ 

USHORT usError; /* Error indicator */ 
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VioSetOrg 

#define INCL_AVI0 /* Or use INCL_PM */ 

USHORT usError = VioSetOrg (sRow, sColumn, hvps) 

SHORT sRow; /* Row number */ 

SHORT sColumn; /* Column number */ 

HVPS hvps; /ie VIO presentation-space handle */ 

USHORT usError; /ie Error indicator iel 


VioShowPS 

#define INCL_AVI0 lie Or use INCL.PM */ 

USHORT usError = VioShowPS (sDepth, sWidth, soffCell, hvps) 

SHORT sDepth; lie The depth of the rectangle in character cell units iel 

SHORT sWidth; /* The width of the rectangle in character cell units iel 

SHORT soffCell; /* Cell offset iel 

HVPS hvps; lie VIO presentation-space handle ie/ 

USHORT usError; /ie Error indicator */ 
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Chapter 9. Window Function Calls 


Win Add Atom 

Idefine INCL.WINATOM /* Or use INCL_WIN or INCL_PM */ 

ATOM atom = WinAddAtom (hatomtblAtomTbl , pszAtomName) 

HATOMTBL hatomtblAtomTbl; /* Atom-table handle */ 

PSZ pszAtomName; /* Atom name */ 

ATOM atom; /* Atom value */ 

WinAddProgram 

fdefine INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCL_PM */ 

HPROGRAM hprogProgHandle = WinAddProgram (hab, ppibProgramlnfo, hprogGroupHandle) 

HAB hab; /* Anchor-block handle */ 

PPIBSTRUCT ppibProgramlnfo; /* Program information for the program to be added to the 

installed program list */ 

HPROGRAM hprogGroupHandle; /* Handle of the program group to which the program is to be 

added */ 

HPROGRAM hprogProgHandle; /* Program handle for the program added to the installed 

program list */ 


WinAddSwitchEntry 

#define INCL_WINSWITCHLIST /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
HSWITCH hswitchSwitch = WinAddSwitchEntry (pswctlSwitchData) 

PSWCNTRL pswctlSwitchData; /* Switch data */ 

HSWITCH hswitchSwitch; /* Handle to the newly-created switch list entry */ 


WinAlarm 

#define INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fResult = WinAlarm (hwndDeskTop, fsStyle) 

HWND hwndDeskTop; /* Desktop-window handle */ 

USHORT fsStyle; /* Alarm style */ 

BOOL fResult; /* Alarm-generated indicator */ 


WinAllocMem 

^define INCL.WINHEAP /* Or use INCL_WIN or INCL_PM */ 

NPBYTE npbMem = WinAllocMem (hheapHeap, uscb) 

HHEAP hheapHeap; /* Heap handle */ 

USHORT uscb; /* Total number of bytes to allocate */ 

NPBYTE npbMem; /* Memory pointer */ 

WinAssociateHelpInstance 

#define INCL_WINHELP /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinAssociateHelpInstance (hwndHelpInstance, hwndApp) 

HWND hwndHelpInstance; /* Handle of an instance of the Help Manager */ 

HWND hwndApp; /* Handle of an application window */ 

BOOL fSuccess; /* Success indicator */ 
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WinAvailMem 

#define INCL_WINHEAP /* Or use INCL_WIN or INCL_PM */ 

USHORT usLargest = WinAvailMem (hheapHeap, fCompact, cb) 

HHEAP hheapHeap; /* Heap handle */ 

BOOL fCompact; /* Compact indicator */ 

USHORT cb; /* Reserved */ 

USHORT usLargest; /* Size of the largest memory block available */ 

WinBeginEnumWindows 

Idefine INCLJIINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HENUM Henum = WinBeginEnumWindows (hwndParent) 

HWND hwndParent; /* Handle of the window whose child windows are to be enumerated */ 
HENUM Henum; /* Enumeration handle */ 

WinBeginPaint 

#define INCL_WINWINDOWMGR /* Or use INCL.WIN or INCL.PM. Also in COMMON section */ 

HPS hpsPaintPS = WinBeginPaint (hwnd, hps, prclRect) 

HWND hwnd; /* Handle of window where drawing is going to occur */ 

HPS hps; /* Presentation-space handle */ 

PRECTL prclRect; /* Bounding rectangle */ 

HPS hpsPaintPS; /* Presentation-space handle */ 

WinBroadcastMsg 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinBroadcastMsg (hwndParent, usMsgld, mpParaml, mpParam2, fsCmd) 

HWND hwndParent; /* Parent -window handle */ 

USHORT usMsgld; /* Message identifier */ 

MPARAM mpParaml; /* Parameter 1 */ 

MPARAM mpParam2; /* Parameter 2 */ 

USHORT fsCmd; /* Broadcast message command */ 

BOOL fSuccess; /* Success indicator */ 

WinCalcFrameRect 

#define INCL_WINFRAMEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinCalcFrameRect (hwnd, prclRect, f Frame) 

HWND hwnd; /* Frame-window handle */ 

PRECTL prclRect; /* Window rectangle */ 

BOOL f Frame; /* Frame indicator iel 

BOOL fSuccess; /* Rectangle-calculated indicator */ 

WinCallMsgFilter 

#define INCL_WINH00KS /* Or use INCL_WIN or INCL_PM */ 

BOOL fHookRet = WinCallMsgFilter (hab, pqmsgpqmsg, usFilter) 

HAB hab; /ie Anchor-block handle ie/ 

PQMSG pqmsgpqmsg; /* Message to be passed to the message-filter hook */ 

USHORT usFilter; /* Filter ie/ 

BOOL fHookRet; /ie Message-filter hook return indicator */ 
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WinCancelShutdown 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinCancelShutdown (hmq, fCancel Always) 

HMQ hmq; /* Queue handle */ 

BOOL fCancel Always; /* Cancellation control */ 

BOOL fSuccess; /* Success indicator */ 

WinCatch 

#define INCL_WINCATCHTHROW /* Or use INCLJIIN or INCL.PM */ 

SHORT sRetCode = WinCatch (pctchbfCatchBuf) 

PCATCHBUF pctchbfCatchBuf; /* Saved execution environment buffer */ 

SHORT sRetCode; /* Return code */ 

WinChangeSwitchEntry 

#define INCL.WINSWITCHLIST /* Or use INCLJIIN or INCL.PM */ 

USHORT usRetCode = WinChangeSwitchEntry (hswitchSwitch, pswctl SwitchData) 

HSWITCH hswitchSwitch; /* Handle to the switch-list entry to be changed */ 
PSWCNTRL pswctl Swi tchData ; /* Switch-control data */ 

USHORT usRetCode; /* Return code */ 

WinCloseClipbrd 

#define INCL_WINCLIPBOARD /* Or use INCLJJIN or INCL_PM */ 

BOOL fSuccess = WinCloseClipbrd (hab) 

HAB hab; /* Anchor-block handle */ 

BOOL fSuccess; /* Success indicator */ 


WinCompareStrings 

#define INCL_WINCOUNTRY /* Or use INCL_WIN or INCL_PM */ 

USHORT usResult = WinCompareStrings (hab, idCodepage, idCountryCode, pszStringl, pszString2, 

fsOptions) 


HAB 

USHORT 

USHORT 

PSZ 

PSZ 

USHORT 


hab; 

idCodepage; 

idCountryCode; 

pszStringl; 

pszString2; 

fsOptions; 


lit Anchor-block handle */ 

lit Codepage identity of both strings */ 

lit Country code */ 

lie String 1 it/ 

lie String 2 */ 

lie Reserved */ 


USHORT usResult; /* Comparison result */ 


WinCopyAccelTable 

#define INCL_WINACCELERATORS /* Or use INCL_WIN or INCL_PM */ 

USHORT usCopied “WinCopyAccelTable (hAccel, pacctAccelTable, usCopyMax) 


HACCEL hAccel; lie Accelerator-table handle */ 

PACCELTABLE pacctAccelTable; /* Accelerator-table data area iel 

USHORT usCopyMax; lie Maximum data area size iel 


USHORT usCopied; 


lie Amount copied or size required */ 
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WinCopyRect 

#define INCL_WINRECTANGLES /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinCopyRect (hab, prclDest, prclSrc) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclDest; /* Destination rectangle */ 

PRECTL prclSrc; /* Source rectangle */ 

BOOL fSuccess; /* Success indicator */ 


WinCpTranslateChar 

#define INCL_WINCOUNTRY /* Or use INCL_WIN or INCL_PM */ 

UCHAR ucDest = WinCpTranslateChar (hab, idCpSource, ucSource, idCpDest) 

HAB hab; /* Anchor-block handle */ 

USHORT idCpSource; /* Source-character code page */ 

UCHAR ucSource; /* Character to be translated */ 

USHORT idCpDest; /* Code page of the resultant character */ 

UCHAR ucDest; /* If nonzero, the translated character */ 


WinCpT ranslateString 

#define I NCL_W INCOUNTRY /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinCpTranslateString (hab, idCpSource, pszSource, idCpDest, cbLenDest, 

pszDest) 

HAB hab; /* Anchor-block handle */ 

USHORT idCpSource; /* Source-string code page */ 

PSZ pszSource; /* String to be translated it/ 

USHORT idCpDest; /it Code page of the resultant string it/ 

USHORT cbLenDest; /it Maximum length of output string it/ 

PSZ pszDest; /* The translated string */ 

BOOL fSuccess; /it Success indicator it/ 


WinCreateAccelTable 

#define INCL_WINACCELERATORS /* Or use INCL_WIN or INCL_PM */ 

HACCEL hAccel = WinCreateAccelTable (hab, pacctAccelTable) 

HAB hab; /it Anchor-block handle it/ 

PACCELTABLE pacctAccelTable; /it Accelerator table */ 

HACCEL hAccel; /it Accel erator-table handle */ 


WinCreateAtomTable 

#define INCL_WINATOM /* Or use INCLJ/IN or INCLJ>M */ 

HATOMTBL hatomtbl AtomTbl = WinCreateAtomTable (uslnitial, usBuckets) 

USHORT uslnitial; /* Initial bytes */ 

USHORT usBuckets; /* Size of the hash table */ 

HATOMTBL hatomtbl AtomTbl ; /* Atom-table handle */ 
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WinCreateCursor 

#define INCL_WINCURSORS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinCreateCursor (hwnd, sx, sy, sex, scy, usrgf, prclClip) 

HWND hwnd; /* Handle of window in which cursor is displayed */ 

SHORT sx; /* x position of cursor */ 

SHORT sy; /* y position of cursor */ 

SHORT sex; /* x size of cursor */ 

SHORT scy; /it y size of cursor */ 

USHORT usrgf; /it Controls the appearance of the cursor it/ 

PRECTL prclClip; /* Cursor rectangle */ 

BOOL fSuccess; /* Success indicator */ 


WinCreateDIg 

#define INCL_WINDIALOGS /it Or use INCL_WIN or INCL_PM */ 

HWND hwndDlg = WinCreateDIg (hwndParent, hwndOwner, pDlgProc, pdlgtDlgTmp, 

pCreateParams) 

HWND hwndParent; /it Parent-window handle of the created dialog window it/ 

HWND hwndOwner; /it Requested owner-window handle of the created dialog window 

*/ 

PFNWP pDlgProc; /* Dialog procedure for the created dialog window */ 

PDLGTEMPLATE pdlgtDlgTmp; /* Dialog template */ 

PVOID pCreateParams; /* Application-defined data area */ 

HWND hwndDlg; /* Dialog-window handle it/ 


WinCreateFrameControls 

#define INCL_WINFRAMEMGR /it Or use INCL.WIN or INCL_PM */ 

BOOL fSuccess = WinCreateFrameControls (hwndFrame, pFcdata, pszTitle) 

HWND hwndFrame; /it Frame-window handle it/ 

PFRAMECDATA pFcdata; /* Frame-control data */ 

PSZ pszTitle; /it Title string */ 

BOOL fSuccess; /* Success indicator */ 


WinCreateGroup 

#define INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCLJM */ 

HPROGRAM hprogGroupHandle = WinCreateGroup (hab, pszTitle, ucVisibil ity # flresl, flres2) 


HAB 

hab; 

/it Anchor-block handle */ 

PSZ 

pszTitle; 

/* Title of the new group */ 

UCHAR 

ucVisibility; 

/it Visibility control */ 

ULONG 

fl resl; 

/it Reserved */ 

ULONG 

fl res2; 

/* Reserved */ 


HPROGRAM hprogGroupHandle; /* Program-group handle for the newly-created group */ 
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WinCreateHeap 


#define 

INCL_WINHEAP 

/* Or use INCL_WIN or INCL_PM */ 

HHEAP 

hHeap = WinCreateHeap (usHeapBase, usHeapSize, usGrow, usMinDed, usMaxDed, 
fsOptions) 

USHORT 

usHeapBase; 

/* Selector of the segment to contain the local heap */ 

USHORT 

usHeapSize; 

/* Initial heap size in bytes */ 

USHORT 

usGrow; 

/* Heap growth size in bytes */ 

USHORT 

usMinDed; 

/* Minimum element size */ 

USHORT 

usMaxDed; 

lie Maximum element size ie/ 

USHORT 

fsOptions; 

lie Optional characteristics icl 

HHEAP 

hHeap; 

lie Heap handle */ 

WinCreateHelpInstance 

^define 

I NC L_W I NH E L P 

lie Or use INCL_WIN or INCL_PM */ 

HWND 

hwndhelp = 

WinCreateHelpInstance (hab, phinitHMInitStructure) 

HAB 

hab; 

/* Anchor-block handle */ 

PHELPINIT phinitHMInitStructure; /* Help Manager initialization structure */ 

HWND 

hwndhelp; 

lie Help Manager handle ie/ 

WinCreateHelpTable 


#define 

INCLJtfINHELP 

lie Or use INCLJIIN or INCL_PM */ 

BOOL 

fSuccess = 

5 WinCreateHelpTable (hwndHelpInstance, phtHel pTable) 


HWND hwndHelpInstance; /* Handle of an instance of the Help Manager */ 

PHELPTABLE phtHel pTable; /* Help table allocated by the application */ 

BOOL fSuccess; /* Success indicator */ 


WinCreateMenu 

^define INCLJtfINMENUS /* Or use INCL_WIN or INCL_PM */ 

HWND hwndMenu = WinCreateMenu (hwndOwner, pmtMenutmp) 

HWND hwndOwner; /* Owner- and parent-window handle of the created menu window */ 
PVOID pmtMenutmp; /* Menu template in binary format */ 

HWND hwndMenu; /* Menu- window handle */ 

WinCreateMsgQueue 

#define INCL_WINMESSAGEMGR /* Or use INCLJIIN or INCL_PM. Also in COMMON section */ 

HMQ hmq = WinCreateMsgQueue (hab, sQueuesize) 

HAB hab; /* Anchor-block handle */ 

SHORT sQueuesize; /* Maximum queue size */ 

HMQ hmq; /* Message-queue handle */ 
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WinCreatePointer 

#def i ne INCL_WINPOINTERS /* Or use INCL_WIN or INCL.PM */ 

HPOINTER hptr = WinCreatePointer (hwndDeskTop, hbmBitMap, fPointerSize, sxHotspot, 

syHotspot) 

HWND hwndDeskTop; /* Desktop-window handle or HWND_DESKTOP */ 

HBITMAP hbmBitMap; /* Bit-map handle from which the pointer image is created */ 

BOOL fPointerSize; /* Pointer-size indicator */ 

SHORT sxHotspot; /* x offset of hotspot within pointer from its lower left corner (in 

pels) */ 

SHORT syHotspot; /* y offset of hotspot within pointer from its lower left corner (in 

pels) */ 

HPOINTER hptr; /* Pointer handle */ 


WinCreatePointerlndirect 

#def i ne INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM it/ 

HPOINTER hptr = WinCreatePointerlndirect (hwndDeskTop, pptriPointerlnfo) 

HWND hwndDeskTop; /* Desktop-window handle or HWND_DESKTOP */ 

PPOINTERINFO pptriPointerlnfo; /* Pointer information structure */ 

HPOINTER hptr; /* Pointer handle */ 


WinCreateStdWindow 

#def i ne INCL_WINFRAMEMGR /* Or use INCL.WIN or INCL_PM. Also in COMMON section */ 

HWND hwndFrame = WinCreateStdWindow (hwndParent, flStyle, pflCreateFlags, pszClassClient, 

pszTitle, flStyleClient, Resource, Id, phwndClient) 

HWND hwndParent; /it Parent -window handle */ 

UL0N6 flStyle; /* Frame-window style */ 

PULONG pflCreateFlags; /* Frame-creation flags */ 

PSZ pszClassClient; /* Client-window class name */ 

PSZ pszTitle; /* Title-bar text */ 

ULONG flStyleClient; /* Client-window style */ 

HMODULE Resource; /* Resource identifier */ 

USHORT Id; /* Frame-window identifier */ 

PHWND phwndClient; /* Client-window handle */ 

HWND hwndFrame; /it Frame-window handle */ 


WinCreateSwitchEntry 

#define INCL_WINSWITCHLIST /* Or use INCL.WIN or INCL_PM */ 

HSWITCH hswitchSwitch = WinCreateSwitchEntry (hab, pswctlSwitchData) 

HAB hab; /it Anchor-block handle */ 

PSWCNTRL pswctlSwitchData; /it Switch data */ 

HSWITCH hswitchSwitch; /* Handle to the newly-created switch list entry */ 
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WinCreate Window 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HWND hwnd = WinCreateWindow (hwndParent, pszClassName, pszName, fl Style, sxcoord, sycoord, 

sWidth, sHeight, hwndOwner, hwndBehind, Id, pCtlData, 
pPresParams) 


HWND 

hwndParent; 

/it Parent-window handle it/ 

PSZ 

pszClassName; 

/it Registered-class name */ 

PSZ 

pszName; 

/it Window text */ 

ULONG 

fl Style; 

/is Window style */ 

SHORT 

sxcoord; 

/is x coordinate of window position ie/ 

SHORT 

sycoord; 

/ie y coordinate of window position ie/ 

SHORT 

sWidth; 

/it Width of window, in window coordinates */ 

SHORT 

sHeight; 

/ie Height of window, in window coordinates */ 

HWND 

hwndOwner; 

/ie Owner-window handle */ 

HWND 

hwndBehind; 

/it Sibling-window handle */ 

USHORT 

Id; 

/ie Window identifier ie/ 

PVOID 

pCtlData; 

/ie Control data it/ 

PVOID 

pPresParams; 

/ie Presentation parameters */ 

HWND 

hwnd; 

/it Window handle */ 

WinDdelnitiate 


#define 

INCL_WINDDE 

tie Or use INCL_WIN or INCL_PM */ 


BOOL fSuccess = WinDdelnitiate (hwndClient, pszAppName, pszTopicName) 

HWND hwndClient; /* Client's window handle */ 

PSZ pszAppName; /* Application name */ 

PSZ pszTopicName; /* Topic name */ 

BOOL fSuccess; /* Success indicator */ 


WinDdePostMsg 

#define INCL_WINDDE /* Or use INCL_WIN or INCL_PM */ 


BOOL fSuccess = WinDdePostMsg (hwndTo, hwndFrom, usMsgld, pddeData, fRetry) 


HWND 

HWND 

USHORT 

PDDESTRUCT 

BOOL 


hwndTo; /* Window handle of target */ 
hwndFrom; /* Window handle of originator */ 
usMsgld; /* Message identifier */ 
pddeData; /* DDE structure */ 
fRetry; /* Retry indicator */ 


BOOL fSuccess; /* Success indicator */ 


WinDdeRespond 


^define 

INCL_WINDDE 

/it Or use INCL_WIN or INCL.PM */ 

MRESULT 

mresReply = 

WinDdeRespond (hwndClient, hwndServer, pszAppName, pszTopicName) 

HWND 

hwndClient; 

/ie Client's window handle ie/ 

HWND 

hwndServer; 

/it Server's window handle */ 

PSZ 

pszAppName; 

/* Application name */ 

PSZ 

pszTopicName 

i; /it Topic name ie/ 

MRESULT 

mresReply; 

/it Message return data */ 
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WinDefAVioWindowProc 

#define INCL_AVI0 /* Or use INCL.PM */ 

MRESULT mresreply = WinDefAVioWindowProc (hwnd, usMsgid, mpParaml, mpParam2) 

HWND hwnd; /* Window handle */ 

USHORT usMsgid; /* Message identity */ 

MPARAM mpParaml; /* Parameter 1 */ 

MPARAM mpParam2; /* Parameter 2 */ 

MRESULT mresreply; /* Message return data */ 


WinDefDIgProc 

#define INCL_WINDIALOGS /* Or use INCLJrflN or INCL_PM. Also in COMMON section */ 
MRESULT mresReply = WinDefDIgProc (hwndDlg, usMsgid, mpParaml, mpParam2) 


HWND 

USHORT 

MPARAM 

MPARAM 


hwndDlg; /* Dialog-window handle */ 
usMsgid; /* Message identity */ 
mpParaml; /* Parameter 1 */ 
mpParam2; /* Parameter 2 */ 


MRESULT mresReply; /* Message-return data */ 


WinDefWindowProc 

^define INCLJIINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
MRESULT mresReply = WinDefWindowProc (hwnd, usMsgid, mpParaml, mpParam2) 


HWND 

USHORT 

MPARAM 

MPARAM 


hwnd; /* Window handle */ 
usMsgid; /* Message identity */ 
mpParaml; /* Parameter 1 */ 
mpParam2; /* Parameter 2 */ 


MRESULT mresReply; /* Message-return data */ 


WinDeleteAtom 

#define INCL.WINATOM /* Or use INCL_WIN or INCL_PM */ 

ATOM ReturnCode = WinDeleteAtom (hatomtblAtomTbl , atom) 


HATOMTBL hatomtbl AtomTbl ; /* Atom-tabl e handl e */ 

ATOM atom; /* Atom identifying the atom to be deleted */ 


ATOM ReturnCode; /* Return code */ 


WinDeleteLibrary 

#define INCLJIINLOAD /* Or use INCLWIN or INCL_PM */ 

BOOL fDeleted = WinDeleteLibrary (hab, hlibLibhandle) 

HAB hab; /* Anchor-block handle */ 

HLIB hlibLibhandle; /* Library handle to be deleted it/ 

BOOL fDeleted; /it Library-deleted indicator */ 

WinDeleteProcedure 

^define INCLJIINLOAD /* Or use INCL_WIN or INCL.PM */ 

BOOL fsuccess = WinDeleteProcedure (hab, pwndproc) 

HAB hab; /* Anchor-block handle */ 

PFNWP pwndproc; /it Window procedure identifier to be deleted */ 
BOOL fsuccess; /* Procedure-deleted indicator it/ 
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Win Destroy AccelTable 

#define I NCL_W IN ACCELERATORS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinDestroyAccel Table (haccelAccel ) 

HACCEL haccelAccel; /* Accel erator-table handle */ 

BOOL fSuccess; /* Success indicator */ 

Win Destroy Atom! able 

#define INCL_WINATQM /* Or use INCL_WIN or INCL_PM */ 

HATOMTBL hatomtblReturnCode = WinDestroyAtomTable (hatomtblAtomTbl ) 

HATOMTBL hatomtblAtomTbl; /* Atom-table handle */ 

HATOMTBL hatomtblReturnCode; /* Return code */ 

WinDestroyCursor 

#define INCL_WINCURSORS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinDestroyCursor (hwnd) 

HWND hwnd; /* Window handle to which the cursor belongs */ 

BOOL fSuccess; /* Success indicator */ 

WinDestroyHeap 

#define INCL_WINHEAP /* Or use INCL_WIN or INCL_PM */ 

HHEAP hheapHeapRet = WinDestroyHeap (hheapHeap) 

HHEAP hheapHeap; /* Heap handle */ 

HHEAP hheapHeapRet; /* Returned heap handle */ 

WinDestroyHelpInstance 

#define INCL_WINHELP /* Or use INCL_WIN or INCL^PM */ 

BOOL fSuccess = WinDestroyHelpInstance (hwndHelpInstance) 

HWND hwndHelpInstance; /* Handle of the instance of the Help Manager to be destroyed */ 
BOOL fSuccess; /* Success indicator */ 

WinDestroyMsgQueue 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fDestroyed = WinDestroyMsgQueue (hmq) 

HMQ hmq; /* Message-queue handle */ 

BOOL fDestroyed; /* Queue-destroyed indicator */ 

WinDestroyPointer 

#define INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinDestroyPointer (hptrPointer) 

HPOINTER hptrPointer; /* Handle of pointer to be destroyed */ 

BOOL fSuccess; /* Success indicator */ 
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WinDestroyWindow 

#define INCL_WINWINDOWMGR /* Or use INCL.WIN or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = WinDestroyWindow (hwnd) 

HWND hwnd; /* Window handle */ 

BOOL fSuccess; /* Window-destroyed indicator */ 

WinDismissDIg 

#define INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinDismissDIg (hwndDlg, usResult) 

HWND hwndDlg; /* Dialog-window handle */ 

USHORT usResult; /* Reply value */ 

BOOL fSuccess; /* Dialog-dismissed indicator */ 

WinDispatchMsg 

#def i ne INCL_WINMES$AGEMGR /* Or use INCLJrfIN or INCL_PM. Also in COMMON section */ 

MRESULT mresReply = WinDispatchMsg (hab, pqmsgMsg) 

HAB hab; /* Anchor-block handle */ 

PQMSG pqmsgMsg; /* Message structure it/ 

MRESULT mresReply; /* Message-return data it/ 


WinDIgBox 

#define INCL_WINDIALOGS /it Or use INCLJJIN or INCL_PM. Also in COMMON section */ 


USHORT usResult = WinDIgBox (hwndParent, hwndOwner, pDlgProc, Resource, usDlgid, 

pCreateParams) 


HWND 

hwndParent; 

/* 

HWND 

hwndOwner; 

/* 

PFNWP 

pDlgProc; 

/* 

HMODULE 

Resource; 

/* 

USHORT 

usDlgid; 

/* 

PVOID 

pCreateParams ; 

/* 

USHORT 

usResult; 

/* 


Parent-window handle of the created dialog window it/ 

Requested owner-window handle of the created dialog window it/ 
Dialog procedure for the created dialog window */ 

Resource identity containing the dialog template */ 
Dialog-template identity within the resource file */ 
Application-defined data area */ 

Reply value */ 


WinDrawBitmap 

#define INCL_WINWINDOWMGR /* Or use INCL.WIN or INCL.PM */ 

BOOL fSuccess = WinDrawBitmap (hps, hbm, prclSrc, pptlDest, lForeColor, IBackColor, 

fsRgf) 


HPS 

HBITMAP 

PRECTL 

PPOINTL 

LONG 

LONG 

USHORT 

BOOL 


hps; 

lie 

hbm; 

/it 

prclSrc; 

/it 

pptlDest; 

/it 

lForeColor; 

/it 

IBackColor; 

/it 

fsRgf; 

tie 

fSuccess; 

/it 


Handle of presentation space in which the bit map is drawn */ 
Bit-map handle it/ 

Subrectangle of bit map to be drawn it/ 

Bit-map destination it/ 

Foreground color */ 

Background color */ 

Flags that determine how the bit map is drawn it/ 

Success indicator it/ 
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WinDrawBorder 

#define INCL_WINWINDOWMGR /* Or use INCLWIN or INCL_PM */ 

BOOL fSuccess = WinDrawBorder (hps, prcl Rectangle, sVertSi deWidth, sHorizSi deWidth, 

IBorderColor, 1 InteriorColor, fsCmd) 

HPS hps; /* Presentation-space handle */ 

PRECTL prcl Rectangle; /* Bounding rectangle for the border */ 

SHORT sVertSideWidth; /* Width of border rectangle vertical sides */ 

SHORT sHorizSideWidth; /* Width of border rectangle horizontal sides */ 

LONG IBorderColor; /* Color of edge of border */ 

LONG 1 InteriorColor; /* Color of interior of border */ 

USHORT fsCmd; /* Flags controlling the way in which the border is drawn */ 

BOOL fSuccess; /* Success indicator */ 


WinDrawPointer 

^define I NCL_W IN POINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinDrawPointer (hps, sx, sy, hptrPointer, usHalftone) 

HPS hps; /* Presentation-space handle into which the pointer is drawn */ 

SHORT sx; /* X coordinate at which to draw the pointer, in device coordinates 

SHORT sy; /* Y coordinate at which to draw the pointer, in device coordinates 

*/ 

HPOINTER hptrPointer; /* Pointer handle */ 

USHORT usHalftone; /* Shading control */ 

BOOL fSuccess; /* Success indicator */ 


WinDrawText 

^define INCLJ/INWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

SHORT sChars = WinDrawText (hps, sCount, pchText, prcl Rectangle, IForeColor, IBackColor, 

fsCmd) 

HPS hps; /* Presentation-space handle */ 

SHORT sCount; /* Count of the number of characters in the string */ 

PCH pchText; /* Character string to be drawn */ 

PRECTL prcl Rectangle; /* Text rectangle */ 

LONG IForeColor; /* Foreground color */ 

LONG IBackColor; /* Background color */ 

USHORT fsCmd; /* An array of flags that determines how the text is drawn */ 

SHORT sChars; /* Count of characters drawn within the rectangle */ 


WinEmptyClipbrd 

#define INCLJIINCLIPBOARD /* Or use INCL_WIN or INCL_PM */ 
BOOL fSuccess = WinEmptyClipbrd (hab) 

HAB hab; /* Anchor-block handle */ 

BOOL fSuccess; /* Success indicator */ 


WinEnablePhysInput 

^define INCLWININPUT /* Or use INCL_WIN or INCL_PM */ 

BOOL fOldlnputState = WinEnablePhysInput (hwndDeskTop, fNewInputState) 

HWND hwndDeskTop; /* Desktop-window handle */ 

BOOL fNewInputState; /* New state for the queuing of physical input */ 

BOOL fOldlnputState; /* Previous state for the queuing of physical input */ 
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WinEnableWindow 

#define INCL_WINWINDOWMGR /* Or use INCLJIIN or INCL_PM */ 

BOOL fSuccess = WinEnableWindow (hwnd, fNewEnabled) 

HWND hwnd; /* Window handle */ 

BOOL fNewEnabled; /* New enabled state */ 

BOOL fSuccess; /* Window enabled indicator */ 

WinEnableWindowUpdate 

fdefine INCL_WINWINDOWMGR /* Or use INCLWIN or INCL_PM */ 

BOOL fSuccess = WinEnableWindowUpdate (hwnd, fNewVisibility) 

HWND hwnd; /* Window handle */ 

BOOL fNewVisibility; /* New visibility state */ 

BOOL fSuccess; /* Visibility-changed indicator */ 

WinEndEnumWindows 

Idefine INCL_WINWINDOWMGR /* Or use INCL_WIN or INCLJ>M */ 

BOOL fSuccess = WinEndEnumWindows (henum) 

HENUM henum; /* Enumeration handle */ 

BOOL fSuccess; /* Success indicator */ 

WinEndPaint 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = WinEndPaint (hps) 

HPS hps; /* Presentation-space handle */ 

BOOL fSuccess; /* Success indicator */ 

WinEnumClipbrdFmts 

#define INCL_WINCLIPBOARD /* Or use INCL_WIN or INCL_PM */ 

USHORT usNext = WinEnumClipbrdFmts (hab, usPrev) 

HAB hab; /* Anchor-block handle */ 

USHORT usPrev; /* Previous clipboard-data format index */ 

USHORT usNext; /* Next clipboard-data format index */ 

WinEnumDIgltem 

^define INCL_WINDIALOGS /* Or use INCLWIN or INCL_PM */ 

HWND hwndltem = WinEnumDIgltem (hwndDlg, hwnd, usCode, fLock) 

HWND hwndDlg; /* Dialog-window handle */ 

HWND hwnd; /* Child-window handle */ 

USHORT usCode; /* Item- type code */ 

BOOL fLock; /* Lock indicator */ 

HWND hwndltem; /* Item-window handle */ 
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WinEqualRect 

#define INCL_WINRECTANGLES /* Or use INCLWIN or INCL_PM */ 

BOOL fEqual = WinEqualRect (hab, prclRectl, prclRect2) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclRectl; /* First rectangle */ 

PRECTL prclRect2; /* Second rectangle */ 

BOOL fEqual; /* Equality indicator */ 

WinExcludeUpdateRegion 

#define INCL_WINWINDOWMGR /* Or use INCLJtfIN or INCL_PM */ 

SHORT sComplexity = WinExcludeUpdateRegion (hps, hwnd) 

HPS hps; /* Presentation-space handle whose clipping region is to be updated */ 

HWND hwnd; /* Window handle */ 

SHORT sComplexity; /* Complexity value */ 

WinFillRect 

^define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCLJ>M. Also in COMMON section */ 

BOOL f Success = WinFillRect (hps, prclRect, 1 Col or) 

HPS hps; /* Presentation-space handle */ 

PRECTL prclRect; /* Rectangle to be filled, in window coordinates */ 

LONG 1 Col or; /* Color with which to fill the rectangle */ 

BOOL fSuccess; /* Success indicator */ 

WinFindAtom 

#defi ne INCL_WINATOM /* Or use INCL_WIN or INCL_PM */ 

ATOM atom = WinFindAtom (hatomtblAtomTbl , pszAtomName) 

HATOMTBL hatomtblAtomTbl; /* Atom-table handle */ 

PSZ pszAtomName; /* Atom name */ 

ATOM atom; /* Atom value */ 

WinFlash Window 

^define INCL_WINFRAMEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinFlashWindow (hwnd, f FI ash) 

HWND hwnd; /it Handle of window to be flashed it/ 

BOOL f FI ash; /* Start-flashing indicator */ 

BOOL fSuccess; /* Success indicator */ 

WinFocusChange 

Idefine INCL_WININPUT /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess a WinFocusChange (hwndDeskTop, hwndNewFocus, fsFocusChange) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HWND hwndNewFocus; /* Window handle to receive the focus */ 

USHORT fsFocusChange; /* Focus changing indicators */ 

BOOL fSuccess; /* Success indicator */ 
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WinFreeErrorlnfo 

^define INCLJ/INERRORS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinFreeErrorlnfo (perriErrorlnfo) 

PERRINFO perriErrorlnfo; /* Error- information block whose memory is to be released */ 

BOOL fSuccess; /* Success indicator */ 


WinFreeMem 

^define INCL_WINHEAP /* Or use INCL_WIN or INCL_PM */ 

NPBYTE npbReturn s WinFreeMem (hheapHeap, npbMem, usLength) 

HHEAP hheapHeap; /* Handle to a heap */ 

NPBYTE npbMem; /* Memory block to be freed */ 

USHORT usLength; /* Size of the memory to be freed */ 

NPBYTE npbReturn; /* Values as follows */ 


WinGetClipPS 

#define INCL_WINWINDOWMGR /* Or use INCLJ/IN or INCL_PM. Also in COMMON section */ 

HPS hps = WinGetClipPS (hwnd, hwndCl ipWindow, usClipflags) 

HWND hwnd; /* Handle of window for which the presentation space is required */ 

HWND hwndCl ipWindow; /it Handle of window for clipping */ 

USHORT usClipflags; /it Clipping control flags it/ 

HPS hps; /it Presentation-space handle that can be used for drawing it/ 

WinGetCurrentTime 

#define INCL_WINTIMER /* Or use INCL_WIN or INCL_PM */ 

ULONG ulTime = WinGetCurrentTime (hab) 

HAB hab; /* Anchor-block handle */ 

ULONG ulTime; /it System-timer count it/ 


WinGetDIgMsg 

#define INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL f Result = WinGetDIgMsg (hwndDlg, pqmsgmsg) 

HWND hwndDlg; /* Dialog-window handle it/ 

PQMSG pqmsgmsg; /* Message structure */ 

BOOL fResult; /* Continue message indicator it/ 


WinGetErrorlnfo 

#define INCL_WINERRORS /it Or use INCL_WIN or INCL_PM it/ 
PERRINFO perriErrorlnfo = WinGetErrorlnfo (hab) 

HAB hab; /it Anchor-block handle */ 

PERRINFO perriErrorlnfo; /* Error information */ 

WinGetKeyState 

#define INCL_WININPUT /* Or use INCL_WIN or INCL_PM */ 

SHORT sKeyState = WinGetKeyState (hwndDeskTop, sVk) 

HWND hwndDeskTop; /it Desktop-window handle: */ 

SHORT sVk; /it Virtual key value */ 

SHORT sKeyState; /* Key state */ 
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WinGetLastError 

#define INCL_WINERROR$ /* Or use INCLJfIN or INCL_PM */ 
ERRORID erridErrorCode = WinGetLastError (hab) 

HAB hab; /* Anchor-block handle */ 

ERRORID erridErrorCode; /* Last-error state */ 


WinGetMinPosition 

#define INCL_WINFRAMEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinGetMinPosition (hwnd, pSwp, pptlPoint) 

HWND hwnd; /* Frame-window handle */ 

PSWP pSwp; /* Set window position structure */ 

PPOINTL pptlPoint; /* Preferred position */ 

BOOL fSuccess; /* Success indicator */ 


WinGetMsg 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL.PM. Also in COMMON section */ 

BOOL f Result = WinGetMsg (hab, pqmsgmsg, hwndFilter, usFirst, usLast) 

HAB hab; /* Anchor-block handle */ 

PQMSG pqmsgmsg; /* Message structure ic/ 

HWND hwndFilter; /* Window filter ic/ 

USHORT usFirst; /* First message identity */ 

USHORT usLast; /* Last message identity ic/ 

BOOL fResult; /ic Continue message indicator */ 


WinGetNextWindow 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 
HWND hwndNext = WinGetNextWindow (henum) 

HENUM henum; /ic Enumeration handle ic/ 

HWND hwndNext; /* Next window handle in enumeration list ic/ 


WinGetPhysKeyState 

#define INCL_WININPUT /* Or use INCL_WIN or INCL_PM */ 

SHORT sKeyState = WinGetPhysKeyState (hwndDeskTop, sScancode) 

HWND hwndDeskTop; /* Desktop-window handle */ 

SHORT sScancode; /* Hardware scancode ic/ 

SHORT sKeyState; /ic Key state */ 

WinGetPS 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section ic/ 

HPS hps = WinGetPS (hwnd) 

HWND hwnd; /* Handle of window for which the presentation space is required ic/ 

HPS hps; /ic Presentation-space handle that can be used for drawing in the window ic/ 
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WinGetScreenPS 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HPS hpsScreenPS = WinGetScreenPS (hwndDeskTop) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HPS hpsScreenPS; /* Presentation-space handle */ 

WinGetSysBitmap 

#define INCL_WINPOINTERS /* Or use INCLWIN or INCL_PM */ 

HBITMAP hbm = WinGetSysBitmap (hwndDeskTop, i Index) 

HWND hwndDeskTop; /* Desktop-window handle */ 

USHORT i Index; /* System bit-map index value */ 

HBITMAP hbm; /* System bit-map handle */ 

WinlnflateRect 

#define INCL_WINRECTANGLES /* Or use INCL.WIN or INCL_PM */ 

BOOL fSuccess = WinlnflateRect (hab, prclrect, sex, scy) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclrect; /* Rectangle to be expanded */ 

SHORT sex; /* Horizontal expansion */ 

SHORT scy; /* Vertical expansion */ 

BOOL fSuccess; /* Success indicator */ 

Winlnitialize 

#define INCL_WINWINDOWMGR /* Or use INCLJIIN or INCL_PM. Also in COMMON section */ 
HAB hab = Winlnitialize (fsOptions) 

USHORT fsOptions; /* Initialization options */ 

HAB hab; /* Anchor-block handle */ 


WinlnSendMsg 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 
BOOL fProcessing = WinlnSendMsg (hab) 

HAB hab; /* Anchor-block handle */ 

BOOL fProcessing; /* Message-processing indicator */ 


WinlnstStartApp 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HAPP happ = WinlnstStartApp (hini, hwndNotify Window, cCount, aszAppli cation, 

pszCmdLine, pData, fsOptions) 


HINI hini; /* Initialization-file handle */ 

HWND hwndNotifyWindow; /* Notification-window handle */ 

USHORT cCount; /* Count of elements in the Application parameter. Must be 1 or 


PSZ FAR * aszAppli cation; 
PSZ pszCmdLine; 

PVOID pData; 

USHORT fsOptions; 


2 */ 

/* Identifier of the application to be started */ 

/* Input parameters for the application to be started */ 
/* Start data */ 

/* Option indicators */ 


HAPP happ; 


/it Application handle */ 
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WinlntersectRect 

#define INCLJrfINRECTANGLES /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinlntersectRect (hab, prclDest, prclRectl, prclRect2) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclDest; /* Intersection rectangle */ 

PRECTL prclRectl; /it First rectangle */ 

PRECTL prclRect2; /* Second rectangle it/ 

BOOL fSuccess; /it Success indicator */ 


WinlnvalidateRect 

#define INCL_WINWINDOWMGR /* Or use INCLJtfIN or INCL_PM */ 

BOOL fSuccess = WinlnvalidateRect (hwnd, prclPrc, flncludeCl ippedChi ldren) 

HWND hwnd; /it Handle of window whose update region is to be changed it/ 

PRECTL prclPrc; /* Update rectangle it/ 

BOOL flncludeCl ippedChi ldren; /* Invalidation-scope indicator it/ 

BOOL fSuccess; /it Success indicator */ 


WinlnvalidateRegion 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM it/ 

BOOL fSuccess = WinlnvalidateRegion (hwnd* hrgn, flncludeCl ippedChi ldren) 

HWND hwnd; /it Handle of window whose update region is to be changed */ 

HRGN hrgn; /* Handle of the region to be added to the window’s update 

region */ 

BOOL flncludeCl ippedChi ldren; /it Invalidation-scope indicator it/ 

BOOL fSuccess; /* Success indicator */ 

WinlnvertRect 

^define INCL_WINWINDOWMGR /it Or use INCL_WIN or INCL_PM it/ 

BOOL fSuccess = WinlnvertRect (hps, prclRect) 

HPS hps; /* Presentation-space handle it/ 

PRECTL prclRect; /it Rectangle to be inverted */ 

BOOL fSuccess; /* Success indicator it/ 


WinlsChild 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM it/ 

BOOL f Related = WinlsChild (hwndChild, hwndParent) 

HWND hwndChild; /it Child-window handle it/ 

HWND hwndParent; /it Parent-window handle */ 

BOOL fRelated; /* Related indicator it/ 


WinlsRectEmpty 

#define I NCL^WIN RECTANGLES /it Or use INCL_WIN or INCL_PM */ 

BOOL fEmpty = WinlsRectEmpty (hab, prclprc) 

HAB hab; /* Anchor-block handle it/ 

PRECTL prclprc; /it Rectangle it/ 

BOOL fEmpty; /it Empty indicator it/ 
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WinlsThreadActive 

#define INCLJIINWINDOWMGR /* Or use INCLJIIN or INCL_PM */ 

BOOL fActive = WinlsThreadActive (hab) 

HAB hab; /* Anchor-block handle of calling thread */ 

BOOL fActive; /* Active-window indicator */ 

WinlsWindow 

#define INCL_WINWINDOWMGR /* Or use INCLJIIN or INCL_PM */ 

BOOL f Valid = WinlsWindow (hab, hwnd) 

HAB hab; /* Anchor-block handle */ 

HWND hwnd; /* Window handle */ 

BOOL fValid; /* Validity indicator */ 

WinlsWindowEnabled 

#define INCLJrfINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL f Enabled = WinlsWindowEnabled (hwnd) 

HWND hwnd; /* Window handle */ 

BOOL fEnabled; /* Enabled-state indicator */ 

WinlsWindowShowing 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCLJ>M. Also in COMMON section */ 
BOOL f Showing = WinlsWindowShowing (hwnd) 

HWND hwnd; /* Window handle */ 

BOOL fShowing; /* Showing state indicator */ 

WinlsWindowVisible 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fVisible = WinlsWindowVisible (hwnd) 

HWND hwnd; /* Window handle */ 

BOOL fVisible; /* Visibility-state indicator */ 

WinLoadAccelTable 

#define INCL_WINACCELERATORS /* Or use INCL_WIN or INCL_PM */ 

HACCEL haccelAccel = WinLoadAccelTable (hab, Resource, idAccelTable) 

HAB hab; /* Anchor-block handle */ 

HMODULE Resource; /* Resource identity containing the accelerator table */ 

USHORT idAccelTable; /* Accelerator-table identifier, within the resource file */ 

HACCEL haccelAccel; /* Accelerator-table handle */ 
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WinLoadDIg 

#define INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

HWND hwndDlg = WinLoadDIg (hwndParent, hwndOwner, pDlgProc, Resource, idDlgid, 

pCreateParams) 

HWND hwndParent; /* Parent-window handle of the created dialog window */ 

HWND hwndOwner; /* Requested owner-window handle of the created dialog window */ 

PFNWP pDlgProc; /* Dialog procedure for the created dialog window */ 

HMODULE Resource; /* Resource identity containing the dialog template */ 

USHORT idDlgid; /* Dial og-templ ate identity within the resource file */ 

PVOID pCreateParams; /* Application-defined data area */ 

HWND hwndDlg; /* Dialog-window handle */ 


WinLoadHelpTable 

#define INCL_WINHELP /* Or use INCL.WIN or INCL_PM */ 

BOOL fSuccess = WinLoadHelpTable (hwndHelpInstance, idHelpTable, Module) 

HWND hwndHelpInstance; /* Handle of a Help Manager instance */ 

USHORT idHelpTable; /* Identity of the help table */ 

HMODULE Module; /* Handle of the module which contains the help table and help 

subtable resources */ 

BOOL fSuccess; /* Success indicator */ 


WinLoadLibrary 

#define INCLJJINLOAD /* Or use INCL_WIN or INCL_PM */ 

HLIB hlibLibhandle = WinLoadLibrary (hab, pszLibname) 

HAB hab; /* Anchor-block handle */ 

PSZ pszLibname; /* Library name */ 

HLIB hlibLibhandle; /* Library handle */ 


WinLoadMenu 

#define INCL_WINMENUS /* Or use INCL_WIN or INCL_PM */ 

HWND hwndMenu = WinLoadMenu (hwndOwner, Resource, idMenuid) 

HWND hwndOwner; /* Owner- and parent-window handle */ 

HMODULE Resource; /* Resource identifier */ 

USHORT idMenuid; /* Menu identifier within the resource file */ 

HWND hwndMenu; /* Menu-window handle */ 


WinLoadPointer 

^define I NCL_WINP0 INTERS /* Or use INCLWIN or INCL_PM */ 

HPOINTER hptr = WinLoadPointer (hwndDeskTop, Resource, idPointer) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HMODULE Resource; /* Resource identity containing the pointer definition */ 

USHORT idPointer; /* Identifier of the pointer to be loaded */ 

HPOINTER hptr; /* Pointer handle */ 
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WinLoadProcedure 

#define INCLJrfINLOAD /* Or use INCL_WIN or INCL_PM */ 

PFNWP pWndproc = WinLoadProcedure (hab, hlibLibhandle, pszProcname) 

HAB hab; /* Anchor-block handle */ 

HUB hlibLibhandle; /* Library handle */ 

PSZ pszProcname; /* Procedure name */ 

PFNWP pWndproc; /* Window-procedure identifier */ 

WinLoadString 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

SHORT sLength = WinLoadString (hab. Resource, idString, sBufferMax, pszBuffer) 

HAB hab; /* Anchor-block handle */ 

HMODULE Resource; /* Resource identity containing the string */ 

USHORT idString; /* String identifier */ 

SHORT sBufferMax; /* Size of buffer */ 

PSZ pszBuffer; /* Buffer that is to receive the string */ 

SHORT sLength; /* The length of the string returned */ 


WinLockHeap 

#define INCL_WINHEAP /* Or use INCL_WIN or INCL_PM */ 

PVOID pStart = WinLockHeap (hheapHeap) 

HHEAP hheapHeap; /* Handle to a heap */ 

PVOID pStart; /* Segment containing the passed heap */ 


WinLockVisRegions 

#defi ne INCL^WINWINDOWMGR /* Or use INCL_WIN or INCL^PM */ 

BOOL f Success = WinLockVisRegions (hwndDeskTop, fLock) 

HWND hwndDeskTop; /* Desktop-window handle or HWND_DESKTOP it/ 

BOOL fLock; /* Indicates whether the visible regions are being locked or unlocked 

*/ 

BOOL f Success; /* Success indicator */ 

WinLockWindow 

#define INCL_WINWINDOWMGR /it Or use INCL_WIN or INCL_PM */ 

HWND hwndRet = WinLockWindow (hwnd, fLock) 

HWND hwnd; /* Window handle it/ 

BOOL fLock; /it Lock indicator */ 

HWND hwndRet; /it Locked-window handle */ 


WinLockWindowllpdate 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = Wi nLockWi ndowUpdate (hwndDeskTop, hwndLockUpdate) 

HWND hwndDeskTop; /it Desktop handle of the screen containing the window to be locked it/ 
HWND hwndLockUpdate; /it Handle of window in which output is to be prevented it/ 

BOOL fSuccess; /it Success indicator it/ 
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WinMakePoints 

Idefine INCL_WINRECTANGLES /* Or use INCLJ/IN or INCL_PM */ 

BOOL fSuccess 53 WinMakePoints (hab, pwptppt, ccount) 

HAB hab; /* Anchor-block handle */ 

PWPOINT pwptppt; /* Points to be converted */ 

USHORT ccount; /* Number of points to be converted */ 

BOOL fSuccess; /it Success indicator */ 

WinMakeRect 

#define INCL_WINRECTANGLE5 /* Or use INCL_WIN or INCL_PM it/ 

BOOL fSuccess = WinMakeRect (hab, pwrcprc) 

HAB hab; /* Anchor-block handle */ 

PWRECT pwrcprc; /* Rectangle to be converted */ 

BOOL fSuccess; /* Success indicator it/ 


WinMapDIgPoints 

#define INCLJIINDIALOGS /* Or use INCL_WIN or INCL_PM it/ 

BOOL fSuccess = WinMapDIgPoints (hwndDlg, aptl Points, usCount, fOptions) 

HWND hwndDlg; /it Dialog-window handle */ 

PPOINTL aptl Points; /* Coordinate points to be mapped */ 

USHORT usCount; /* Number of coordinate points it/ 

BOOL fOptions; /* Calculation control */ 

BOOL fSuccess; /* Coordinates-mapped indicator */ 

WinMapWindowPoints 

^define INCL_WINWINDOWMGR /it Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinMapWindowPoints (hwndFrom, hwndTo, aptl Points, sCount) 

HWND hwndFrom; /* Handle of the window from whose coordinates points are to be mapped 
*/ 

HWND hwndTo; /* Handle of the window to whose coordinates points are to be mapped */ 

PPOINTL aptl Points; /it Points to be mapped to the new coordinate system */ 

SHORT sCount; /it Number of points to be mapped */ 

BOOL fSuccess; /* Success indicator */ 


WinMessageBox 

#define INCL.WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

USHORT usResponse = WinMessageBox (hwndParent, hwndOwner, pszText, pszTitle, usWindow, 

fsStyle) 

HWND hwndParent; /it Parent-window handle of the created message-box window it/ 

HWND hwndOwner; /it Requested owner-window handle of the created message-box window it/ 

PSZ pszText; /* Message-box window message */ 

PSZ pszTitle; /it Message-box window title */ 

USHORT usWindow; /* Message-box window identity */ 

USHORT fsStyle; /it Message-box window style */ 

USHORT usResponse; /it User-response value */ 
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WinMsgMuxSemWait 

#def i ne INCLJIINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 

USHORT usrc - WinMsgMuxSemWait (pusIndexNbr, pList, dtTimeout) 

PUSHORT pusIndexNbr; /* Index of the cleared semaphore in the list */ 

PVOID pList; /* List of semaphore descriptors */ 

LONG dtTimeout; /* Function time-out value */ 

USHORT usrc; /* Return code */ 


WinMsgSemWait 

Idefine INCL_WINMESSAGEMGR /* Or use INCLWIN or INCL_PM */ 

USHORT usrc = WinMsgSemWait (hsem, dtTimeout) 

HSEM hsem; /* Semaphore handle */ 

LONG dtTimeout; /* Function time-out value */ 

USHORT usrc; /* Return code */ 


WinMultWindowFromIDs 

^define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCLPM ief 

SHORT sWindows = WinMultWindowFromIDs (hwndParent, ahwnd, usFirst, usLast) 

HWND hwndParent; /* Parent-window handle ief 

PHWND ahwnd; /* Window handles ief 

USHORT usFirst; fie First window identity value in the range (inclusive) ief 

USHORT usLast; fie Last window identity value in the range (inclusive) */ 

SHORT sWindows; fie Number of window handles returned */ 


WinNextChar 

#define INCL_WINCOUNTRY fie Or use INCL_WIN or INCL_PM */ 

PSZ pszNextChar = WinNextChar (hab, usCodepage, usCountry, pszCurrentChar) 

HAB hab; /* Anchor-block handle */ 

USHORT usCodepage; fie Code page */ 

USHORT usCountry; fie Country code ief 

PSZ pszCurrentChar; /* Current character in a null -terminated string */ 

PSZ pszNextChar; /* Next character in the null -terminated string ief 


WinOffsetRect 

#def i ne INCL_WINRECTANGLES /* Or use INCL_WIN or INCLJ>M */ 

BOOL fSuccess = WinOffsetRect (hab, prclrect, sex, scy) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclrect; /* Rectangle to be offset */ 

SHORT sex; /* x value of offset */ 

SHORT scy; fie y value of offset */ 

BOOL fSuccess; /* Success indicator ief 


WinOpenClipbrd 

#define INCL_WINCLIPBOARD /* Or use INCLWIN or INCL_PM */ 
BOOL fSuccess = WinOpenClipbrd (hab) 

HAB hab; /* Anchor-block handle */ 

BOOL fSuccess; /* Success indicator */ 
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WinOpenWindowDC 

Idefine INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
HDC hdc = WinOpenWindowDC (hwnd) 

HWND hwnd; /* Window handle */ 

HDC hdc; /* Device-context handle */ 


WinPeekMsg 

^define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL.PM. Also in COMMON section */ 

BOOL fResult = WinPeekMsg (hab, pqmsgmsg, hwndFilter, usFirst, usLast, fsOptions) 

HAB hab; /* Anchor-block handle */ 

PQMSG pqmsgmsg; /* Message structure */ 

HWND hwndFilter; /* Window filter */ 

USHORT usFirst; /* First message identity */ 

USHORT usLast; /* Last message identity */ 

USHORT fsOptions; /* Options */ 

BOOL fResult; /* Message-available indicator */ 


WinPostMsg 

#defi ne INCL_WINME$SAGEMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fResult = WinPostMsg (hwnd, usMsgid, mpParaml, mpParam2) 

HWND hwnd; /* Window handle */ 

USHORT usMsgid; /* Message identity */ 

MPARAM mpParaml; /* Parameter 1 */ 

MPARAM mpParam2; /* Parameter 2 */ 

BOOL fResult; /* Message-posted indicator */ 


WinPostQueueMsg 

#define INCL_WINMESSAGEMGR /* Or use INCL.WIN or INCLJ>M */ 

BOOL fSuccess = WinPostQueueMsg (hmq, usMsgid, mpParaml, mpParam2) 

HMQ hmq; /* Message-queue handle */ 

USHORT usMsgid; /* Message identifier */ 

MPARAM mpParaml; /* Parameter 1 */ 

MPARAM mpParam2; /* Parameter 2 */ 

BOOL fSuccess; /* Success indicator */ 


WinPrevChar 

#define INCL_WINCOUNTRY /* Or use INCL_WIN or INCLJ>M */ 

PSZ pszPrevChar = WinPrevChar (hab, usCodepage, usCountry, pszStart, pszCurrentChar) 

HAB hab; /* Anchor-block handle */ 

USHORT usCodepage; /* Code page */ 

USHORT usCountry; /* Country code */ 

PSZ pszStart; /* Character string that contains CurrentChar */ 

PSZ pszCurrentChar; /* Current character */ 

PSZ pszPrevChar; /* Previous character */ 


WinProcessDIg 

#define I NCL_W INDIA LOGS /* Or use INCL_WIN or INCL_PM */ 

USHORT usResult = WinProcessDIg (hwndDlg) 

HWND hwndDlg; /* Dialog-window handle */ 

USHORT usResult; /* Reply value */ 
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WinPtlnRect 

#define INCL_WINRECTANGLES /* Or use INCLWIN or INCL.PM */ 

BOOL f = WinPtlnRect (hab, prclrect, pptlpoint) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclrect; /* Rectangle to be queried */ 

PPOINTL pptlpoint; /* Point to be queried */ 

BOOL f; /* Success indicator */ 


WinQueryAccelTable 

#define INCL_WINACCELERATORS /* Or use INCL_WIN or INCL_PM */ 

HACCEL haccelAccel = WinQueryAccelTable (hab, hwndFrame) 

HAB hab; /* Anchor-block handle */ 

HWND hwndFrame; /* Frame-window handle */ 

HACCEL haccelAccel; /* Accel erator-table handle */ 


WinQueryActiveWindow 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HWND hwndActive = WinQueryActiveWindow (hwndParent, fLock) 

HWND hwndParent; /* Parent-window handle for which the active window is required */ 
BOOL fLock; /* Windows lock-state indicator */ 

HWND hwndActive; /* Active-window handle */ 


WinQueryAnchorBlock 

#define INCL_WINWINDOWMGR /* Or use INCLJ/IN or INCLJ>M. Also in COMMON section */ 
HAB hab = WinQueryAnchorBlock (hwnd) 

HWND hwnd; /* Window handle */ 

HAB hab; /* Anchor block handle */ 


WinQueryAtomLength 

#define INCLJrfINATOM /* Or use INCL_WIN or INCL_PM */ 

USHORT usretlen = WinQueryAtomLength (hatomtblAtomTbl , atom) 

HATOMTBL hatomtblAtomTbl; /* Atom-table handle */ 

ATOM atom; /* Atom whose associated character-string length is to be 

returned */ 

USHORT usretlen; /* String length */ 


WinQueryAtomName 

#define INCL_WINATOM /* Or use INCLWIN or INCL.PM */ 

USHORT usretlen = WinQueryAtomName (hatomtblAtomTbl, atom, pszBuffer, usBufferMax) 
HATOMTBL hatomtblAtomTbl; /* Atom-table handle */ 

ATOM atom; /* Atom; identifies the character string to be retrieved it/ 

PSZ pszBuffer; /* Buffer to receive the character string it/ 

USHORT usBufferMax; /ie Buffer size in bytes */ 

USHORT usretlen; /it Length of retrieved character string */ 
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WinQueryAtomUsage 

#define INCL_WINATOM /* Or use INCL_WIN or INCL_PM */ 

USHORT uscount = WinQueryAtomUsage (hatomtblAtomTbl, atom) 

HATOMTBL hatomtblAtomTbl; /* Atom-table handle */ 

ATOM atom; /* Atom whose use count is to be returned */ 

USHORT uscount; /* Use count of the atom */ 


WinQueryCapture 

#define INCL_WININPUT /* Or use INCL_WIN or INCLPM */ 

HWND hwnd = WinQueryCapture (hwndDesktop, fLock) 

HWND hwndDesktop; /* Desktop-window handle */ 

BOOL fLock; /* Lock-request indicator */ 

HWND hwnd; /* Handle of the window with the pointer captured */ 


WinQueryClassInfo 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fExists = WinQueryClassInfo (hab, pszClassName, pclsiClassInfo) 

HAB hab; /* Anchor-block handle */ 

PSZ pszClassName; lie Class name ie/ 

PCLASSINFO pclsiClassInfo; /* Class information structure */ 

BOOL fExists; /* Class-exists indicator */ 


WinQueryClassName 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

SHORT sRetLen = WinQueryClassName (hwnd, sLength, pchBuffer) 

HWND hwnd; /* Window handle ie/ 

SHORT sLength; /* Length of Buffer ie/ 

PCH pchBuffer; /* Class name */ 

SHORT sRetLen; /ie Returned class name length ie/ 


WinQueryClipbrdData 

#define I NCL_WIN CLIPBOARD /ie Or use INCL_WIN or INCL_PM */ 

ULONG ulData = WinQueryClipbrdData (hab, usfmt) 

HAB hab; /* Anchor-block handle */ 

USHORT usfmt; /* Format of the data to be accessed */ 

ULONG ulData; /ie Handle to the clipboard data ie/ 


WinQueryClipbrdFmtlnfo 

#define INCL_WINCLIPBOARD /* Or use INCL_WIN or INCL_PM ie/ 

BOOL fExists = WinQueryClipbrdFmtlnfo (hab, usfmt, pusFmtlnfo) 

HAB hab; /ie Anchor-block handle */ 

USHORT usfmt; /ie Format of the data to be queried */ 

PUSHORT pusFmtlnfo; /ie Memory model and usage flags */ 

BOOL fExists; /* Format-exists indicator ie/ 
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WinQueryClipbrdOwner 

#define INCLWINCLIPBOARD /* Or use INCL_WIN or INCL_PM */ 

HWND hwndClipbrdOwner = WinQueryClipbrdOwner (hab, fLock) 

HAB hab; /* Anchor-block handle */ 

BOOL fLock; /* Lock state indicator of clipboard owner window */ 

HWND hwndClipbrdOwner; /* Window handle of the current clipboard owner */ 

WinQueryClipbrdViewer 

#define INCL_WINCLIPBOARD /* Or use INCL_WIN or INCL^PM */ 

HWND hwndClipbrdViewer = WinQueryClipbrdViewer (hab, fLock) 

HAB hab; /* Anchor-block handle */ 

BOOL fLock; /* Lock-state indicator of clipboard viewer window */ 

HWND hwndClipbrdViewer; /* Current clipboard viewer window handle */ 

WinQueryCp 

#define INCLWINCOUNTRY /* Or use INCLJtfIN or INCL_PM */ 

USHORT usCodePage = WinQueryCp (hmq) 

HMQ hmq; /* Message queue */ 

USHORT usCodePage; /* Code page */ 

WinQueryCpList 

Idefine INCL_WINCOUNTRY /* Or use INCL_WIN or INCL_PM */ 

USHORT usTotCount = WinQueryCpList (hab, uscount, ausCodepage) 

HAB hab; /* Anchor-block handle */ 

USHORT uscount; /* Maximum number of code pages returned */ 

PUSHORT ausCodepage; /* Code page list */ 

USHORT usTotCount; /* Total number of code pages available */ 

WinQueryCursorlnfo 

fdefine INCLJIINCURSORS /* Or use INCL_WIN or INCL_PM */ 

BOOL fCursor = WinQueryCursorlnfo (hwndDeskTop, pcsriCursorlnfo) 

HWND hwndDeskTop; /* Desktop-window handle */ 

PCURSORINFO pcsriCursorlnfo; /* Cursor information */ 

BOOL fCursor; /* Current-cursor indicator */ 


WinQueryDefinition 

#defi ne INCL_WINPROGRAMLIST /* Or use INCLJtfIN or INCL_PM */ 


USHORT usLength = WinQueryDefinition (hab, hprogProgHandle, ppibProgramlnfo, 

usMaxLength) 


HAB 

H PROGRAM 

PPIBSTRUCT 

USHORT 


hab; 

hprogProgHandle; 

ppibProgramlnfo; 

usMaxLength; 


/* Anchor-block handle */ 

/* Handle of the program whose information is to be returned */ 
/* Program-information data */ 

/* Maximum length in bytes */ 


USHORT usLength; 


/* Length of returned data */ 
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WinQueryDesktopWindow 

#define INCL_WINWINDOWMGR /* Or use INCLJIIN or INCL_PM */ 

HWND hwndDeskTop = WinQueryDesktopWindow (hab, hdc) 

HAB hab; /* Anchor-block handle */ 

HDC hdc; /* Device-context handle */ 

HWND hwndDeskTop; /* Desktop-window handle */ 

WinQueryDIgltemShort 

Idefine INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM, Also in COMMON section */ 
BOOL fSuccess s WinQueryDIgltemShort (hwndDlg, idltem, psResult, fSigned) 

HWND hwndDlg; /* Parent-window handle */ 

USHORT idltem; /* Identity of the child window whose text is to be converted */ 

PSHORT psResult; /* Integer value resulting from the conversion */ 

BOOL fSigned; /* Sign indicator */ 

BOOL fSuccess; /* Success indicator */ 

WinQueryDIgltemText 

#define INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
USHORT usRetLen = WinQueryDIgltemText (hwndDlg, idltem, sMaxText, pszText) 

HWND hwndDlg; /* Parent-window handle */ 

USHORT idltem; /* Identity of the child window whose text is to be queried */ 

SHORT sMaxText; /* Length of Text */ 

PSZ pszText; /* Output string */ 

USHORT usRetLen; /* Actual number of characters returned */ 

WinQueryDIgltemTextLength 

^define INCLWINDIALOGS /* Or use INCLWIN or INCL_PM. Also in COMMON section */ 
SHORT sRetLen = WinQueryDIgltemTextLength (hwndDlg, idltem) 

HWND hwndDlg; /* Parent-window handle */ 

USHORT idltem; /* Identity of the child window whose text is to be queried */ 
SHORT sRetLen; /* Length of text */ 

WinQueryFocus 

#define INCL_WININPUT /* Or use INCLJ/IN or INCL_PM */ 

HWND hwndFocus = WinQueryFocus (hwndDeskTop, fLock) 

HWND hwndDeskTop; /* Desktop-window handle */ 

BOOL fLock; /* Window lock state indicator it/ 

HWND hwndFocus; /it Focus-handle */ 

WinQueryHelpInstance 

^define INCL_WINHELP /* Or use INCL_WIN or INCL_PM */ 

HWND hwndHelp = WinQueryHelpInstance (hwndApp) 

HWND hwndApp; /* Handle of the application window */ 

HWND hwndHelp; /* Help Manager window handle it/ 
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WinQueryMsgPos 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryMsgPos (hab, pptlptrpos) 

HAB hab; /* Anchor-block handle */ 

PPOINTL pptlptrpos; /* Pointer position in screen coordinates */ 

BOOL fSuccess; /* Success indicator */ 

WinQueryMsgTime 

fdefine INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 

ULONG ulTime = WinQueryMsgTime (hab) 

HAB hab; /* Anchor-block handle */ 

ULONG ulTime; /* Time in milliseconds */ 

WinQueryObjectWindow 

fdefine INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HWND hwndObject = WinQueryObjectWindow (hwndDeskTop) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HWND hwndObject; /* Object-window handle */ 

WinQueryPointer 

fdefine INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

HPOINTER hptrPointer = WinQueryPointer (hwndDeskTop) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HPOINTER hptrPointer; /* Pointer handle */ 

WinQueryPointerlnfo 

fdefine INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryPointerlnfo (hptr, pptriPointerlnfo) 

HPOINTER hptr; /* Pointer handle */ 

PPOINTERINFO pptriPointerlnfo; /* Pointer-information structure */ 

BOOL fSuccess; /* Success indicator */ 

WinQueryPointerPos 

fdefine INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryPointerPos (hwndDeskTop, pptlPoint) 

HWND hwndDeskTop; /* Desktop-window handle */ 

PPOINTL pptlPoint; /* Pointer position in screen coordinates */ 

BOOL fSuccess; /* Pointer position returned indicator */ 
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WinQueryPresParam 

#define INCL_WINSYS /* Or use INCL_WIN or INCL_PM */ 

ULONG cbRetLen = WinQueryPresParam (hwnd, idAttrTypel, idAttrType2, pidAttrTypeFound, 

cbAttrValueLen, pAttrValue, fsOptions) 

HWND hwnd; /* Window handle */ 

ULONG idAttrTypel; /* First attribute type identity */ 

ULONG idAttrType2; /* Second attribute type identity */ 

PULONG pidAttrTypeFound; /* Attribute type identity found */ 

ULONG cbAttrValueLen; /* Byte count of the size of the AttrValue parameter */ 

PVOID pAttrValue; /* Attribute value */ 

USHORT fsOptions; /* Options */ 

ULONG cbRetLen; /* Length of presentation parameter value passed back */ 

WinQueryProfileData 

#define INCLJtfINSHELLDATA /* Or use INCL_WIN or INCLJ>M */ 

BOOL fSuccess = WinQueryProfileData (hab, pszAppName, pszKeyName, pValue, pusSize) 

HAB hab; /* Anchor-block handle */ 

PSZ pszAppName; /it Application name */ 

PSZ pszKeyName; /* Key name */ 

PVOID pValue; /* Value data */ 

PUSHORT pusSize; /it Size of value data it/ 

BOOL fSuccess; /* Success indicator */ 

WinQueryProfilelnt 

^define INCLJ/INSHELLDATA /it Or use INCL_WIN or INCL_PM it/ 

SHORT sRequiredlnteger = WinQueryProfilelnt (hab, pszAppName, pszKeyName, sDefault) 


HAB 

hab; 

/* Anchor-block handle */ 

PSZ 

pszAppName; 

/* Application name */ 

PSZ 

pszKeyName; 

/* Key name */ 

SHORT 

sDefault; 

/it Default value */ 


SHORT sRequiredlnteger; /* Key value specified in the intial ization file it/ 

WinQueryProfileSize 

#define INCL_WINSHELLDATA /* Or use INCLJ/IN or INCL_PM */ 

USHORT usRetCode = WinQueryProfileSize (hab, pszAppName, pszKeyName, pusValue) 

HAB hab; /* Anchor-block handle it/ 

PSZ pszAppName; /* Application name */ 

PSZ pszKeyName; /* Key name */ 

PUSHORT pusValue; /* Data length */ 

USHORT usRetCode; /* Success indicator it/ 


9-30 PM C/2 Bindings Reference 



WinQueryProfileString 

#define INCL_WINSHELLDATA /* Or use INCLJ/IN or INCLJ>M */ 

USHORT usPstring = WinQueryProfileString (hab, pszAppName, pszKeyName, pszDefault, 

pProfileString, usMaxPstring) 

HAB hab; /* Anchor-block handle */ 

PSZ pszAppName; /* Application name */ 

PSZ pszKeyName; /* Key name */ 

PSZ pszDefault; /* Default string */ 

PVOID pProfileString; /* Profile string */ 

USHORT usMaxPstring; /* Maximum number */ 

USHORT usPstring; /* Actual number */ 


WinQueryProgramTitles 

#define INCL_WINPROGRAMLIST /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryProgramTitles (hab, hprogGroup, aprogeBuffer, usBufferLen, 

pusTotal) 

HAB hab; /* Anchor-block handle */ 

HPROGRAM hprogGroup; /* Handle of the program group whose information is to be 

returned */ 

PPROGRAMENTRY aprogeBuffer; /* Program information buffer */ 

USHORT usBufferLen; /* Buffer length if/ 

PUSHORT pusTotal; /* Total number of structures */ 

BOOL fSuccess; /* Success indicator if/ 


WinQueryQueuelnfo 

#define INCL_WINMESSAGEMGR /* Or use INCL.WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinQueryQueuelnfo (hmq, pmqiMqinfo, cbCopied) 

HMQ hmq; /* Queue handle */ 

PMQINFO pmqiMqinfo; /* Message queue information structure to contain the queue information 

it/ 

USHORT cbCopied; /* Size of message queue information structure that is provided (in 

bytes) if/ 

BOOL fSuccess; /* Success indicator */ 


WinQueryQueueStatus 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 
ULONG fl Status = WinQueryQueueStatus (hwndDeskTop) 

HWND hwndDeskTop; /* Desktop-window handle */ 

ULONG fl Status; /* Status information */ 


WinQuerySessionTitle 

#define INCL_WINSWITCHLIST /if Or use INCLJUN or INCL_PM */ 

USHORT usRetCode - WinQuerySessionTitle (hab, usSession, pszTitle, usTitlelen) 

HAB hab; /* Anchor-block handle it/ 

USHORT usSession; /if IBM Operating System/2 session identity of application whose title is 

requested */ 

PSZ pszTitle; /* Task title */ 

USHORT usTitlelen; /if Maximum length of data returnable in bytes */ 

USHORT usRetCode; /* Return code */ 
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WinQuerySwitchEntry 

^define INCL_WINSWITCHLIST /* Or use INCLJtfIN or INCL_PM */ 

USHORT usRetCode = WinQuerySwitchEntry (hswitchSwitch, pswctl SwitchData) 

HSWITCH hswitchSwitch; /* Handle to the task list entry */ 

PSWCNTRL pswctl SwitchData; /* Switch control data */ 

USHORT usRetCode; /* Return code */ 


WinQuerySwitchHandle 

^define INCL_WINSWITCHLIST /* Or use INCL_WIN or INCL_PM */ 

HSWITCH hswitchSwitch = WinQuerySwitchHandle (hwnd, idProcess) 

HWND hwnd; /* Window handle of an application */ 

PID idProcess; /* Process identity of the application */ 

HSWITCH hswitchSwitch; /* Switch list handle for the specified application */ 


WinQuerySwitchList 

#define INCL_WINSWITCHLIST /* Or use INCL_WIN or INCL_PM */ 

USHORT usCount = WinQuerySwitchList (hab, pswbl kSv/itchEntries, usDataLength) 

HAB hab; /* Anchor-block handle */ 

PSWBLOCK pswbl kSwitchEntries; /* Switch entries block */ 

USHORT usDataLength; /* Maximum length of data returnable in bytes */ 

USHORT usCount; /* Total number of switch list entries present in the system 

*/ 


WinQuerySysColor 

#define INCL_WINSYS /* Or use INCL_WIN or INCL_PM */ 

LONG lRgbColor = WinQuerySysColor (hwndDeskTop, 1 Col or, 1 Reserved) 

HWND hwndDeskTop; /* Desktop-window handle */ 

LONG 1 Col or; /* System color-index value */ 

LONG 1 Reserved; /* Reserved */ 

LONG lRgbColor; /* RGB value */ 


WinQuerySysModalWindow 

ifdefine INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HWND hwndSysModal = WinQuerySysModalWindow (hwndDeskTop, fLock) 

HWND hwndDeskTop; /* Desktop-window handle */ 

BOOL fLock; /* Window's lock-state indicator */ 

HWND hwndSysModal; /* Handle of system modal window */ 


WinQuerySysPointer 

^define INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

HPOINTER hptrPointer = WinQuerySysPointer (hwndDeskTop, sldentifier, fCopy) 

HWND hwndDeskTop; /* Desktop-window handle ie/ 

SHORT sldentifier; /* System-pointer identifier ie/ 

BOOL fCopy; /* Copy indicator */ 

HPOINTER hptrPointer; /* Pointer handle */ 
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WinQuerySystem AtomT able 

#define INCL_WINATOM /* Or use INCL_WIN or INCL_PM */ 
HATOMTBL hatomtblAtomTbl = Wi nQuerySystemAtomTabl e (VOID) 
HATOMTBL hatomtblAtomTbl; /* System atom-table handle */ 

WinQuerySysValue 

Idefine INCLJIINSYS /* Or use INCL_WIN or INCL_PM */ 

LONG lValue = WinQuerySysValue (hwndDeskTop, sValueid) 

HWND hwndDeskTop; /* Desktop-window handle */ 

SHORT sValueid; /* System-value identity */ 

LONG lValue; /* System value */ 


WinQueryTaskSizePos 

#define INCL_WINSWITCHLIST /* Or use INCL_WIN or INCL_PM */ 

USHORT usRetCode = WinQueryTaskSizePos (hab, usScreenGroup, pswpPositionData) 

HAB hab; /* Anchor-block handle */ 

USHORT usScreenGroup; /* Screen group */ 

PSWP pswpPositionData; /* Window position and size data */ 

USHORT usRetCode; /* Return code */ 

WinQueryT askTitle 

#define INCL_WINSWITCHLIST /* Or use INCL_WIN or INCL_PM */ 

USHORT usRetCode = WinQueryTaskTitle (usSession, pszTitle, usTitlelen) 

USHORT usSession; /* Session identity of application whose title is requested */ 

PSZ pszTitle; /* Task title */ 

USHORT usTitlelen; /* Maximum length of data returnable in bytes */ 

USHORT usRetCode; /* Return code */ 


WinQueryUpdateRect 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryUpdateRect (hwnd, prclPrc) 

HWND hwnd; /* Handle of window whose update rectangle is to be queried */ 

PRECTL prclPrc; /* Update region that bounds the rectangle (in window coordinates) */ 

BOOL fSuccess; /* Success indicator */ 


WinQueryUpdateRegion 

fdefine INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

SHORT sComplexity = WinQueryUpdateRegion (hwnd, hrgn) 

HWND hwnd; /* Handle of window whose update region is to be queried */ 

HRGN hrgn; /* Handle of the window's update region */ 

SHORT sComplexity; /* Complexity of resulting region/error indicator */ 

WinQueryVersion 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
ULONG flSysInf B WinQueryVersion (hab) 

HAB hab; /* Anchor-block handle */ 

ULONG flSysInf; /* System information within which the application is operating */ 
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WinQueryWindow 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL.PM */ 

HWND hwndRelated = WinQueryWindow (hwnd, sCode, fLock) 

HWND hwnd; /* Handle of window to query */ 

SHORT sCode; /* Type of window information */ 

BOOL fLock; /* Lock control */ 

HWND hwndRelated; /* Window handle */ 

WinQueryWindowDC 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HDC hdc = WinQueryWindowDC (hwnd) 

HWND hwnd; /* Window handle */ 

HDC hdc; /* Device-context handle */ 

WinQueryWindowLockCount 

^define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

SHORT sLock = WinQueryWindowLockCount (hwnd) 

HWND hwnd; /* Window handle */ 

SHORT sLock; /* Window-lock count */ 

WinQueryWindowPos 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryWindowPos (hwnd, pswp) 

HWND hwnd; /* Window handle */ 

PSWP pswp; /* SWP structure */ 

BOOL fSuccess; /* Success indicator */ 

WinQuery Wi ndowProcess 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinQueryWi ndowProcess (hwnd, pidpid, pidtid) 

HWND hwnd; /* Window handle */ 

PPID pidpid; /* Process identity of the thread that created the window */ 

PTID pidtid; /* Thread identity of the thread that created the window */ 

BOOL fSuccess; /* Success indicator */ 

WinQueryWindowPtr 

#define INCL_WINWINDOWMGR /* Or use INCLJrfIN or INCL_PM */ 

PVOID pp = WinQueryWindowPtr (hwnd, sb) 

HWND hwnd; /* Window handle */ 

SHORT sb; lie Index */ 

PVOID pp; /it Pointer value */ 
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WinQueryWindowRect 

Idefine INCL_WINWINDOWMGR /* Or use INCL.WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinQueryWindowRect (hwnd, prclRect) 

HWND hwnd; /* Window handle */ 

PRECTL prclRect; /* Window rectangle */ 

BOOL fSuccess; /* Rectangle-returned indicator */ 


WinQueryWindowText 

#define INCLJ/INWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

SHORT sRetLen = WinQueryWindowText (hwnd, sLength, pchBuffer) 

HWND hwnd; /* Window handle */ 

SHORT sLength; /* Length */ 

PCH pchBuffer; /* Window text */ 

SHORT sRetLen; /* Length of returned text */ 


WinQueryWindowTextLength 

#define INCLJrfINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 
SHORT sRetLen = WinQueryWindowTextLength (hwnd) 

HWND hwnd; /* Window handle */ 

SHORT sRetLen; /* Length of the window text */ 


WinQuery Wi ndowULong 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

ULONG ul Value = WinQueryWi ndowULong (hwnd, sb) 

HWND hwnd; /* Handle of window to be queried ie/ 

SHORT sb; /* Index */ 

ULONG ulValue; /* Value contained in the window word ie/ 


WinQueryWindowUShort 

#define INCL^WINWINDOWMGR /* Or use INCL_WIN or INCL_PM ie/ 

USHORT usValue = WinQueryWindowUShort (hwnd, sb) 

HWND hwnd; /* Handle of window to be queried */ 

SHORT sb; /* Index */ 

USHORT usValue; /* Value contained in the indicated window word */ 


WinReallocMem 

#define INCL^WINHEAP /* Or use INCLJIIN or INCL_PM ie/ 

NPBYTE npbMem = WinReallocMem (hHeap, npbMemObj, usOld, usNew) 

HHEAP hHeap; /ie Handle to a heap ie/ 

NPBYTE npbMemObj; /ie Memory object ie/ 

USHORT usOld; /ie Old size ie/ 

USHORT usNew; /* New size */ 

NPBYTE npbMem; /* Pointer to memory block ie/ 
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WinRegisterClass 

^define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fRegistered = WinRegisterClass (hab, pszClassName, pWndProc, flClassStyle, usExtra) 

HAB hab; /* Anchor-block handle */ 

PSZ pszClassName; /* Window-class name */ 

PFNWP pWndProc; /* Window-procedure identifier */ 

ULONG flClassStyle; /* Default-window style */ 

USHORT usExtra; /* Reserved storage */ 

BOOL fRegistered; /* Window-class-registration indicator */ 


WinRegisterllserDatatype 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinRegisterUserDatatype (hab, sDatatype, sCount, asTypes) 

HAB hab; /* Anchor-block handle */ 

SHORT sDatatype; /* Data type code to be defined */ 

SHORT sCount; /* Number of elements */ 

PSHORT asTypes; /* Data type codes of structure components */ 

BOOL fSuccess; /* Success indicator */ 


WinRegisterUserMsg 

Idefine INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinRegisterUserMsg (hab, usMsgid, sTypel, sDirl, sType2, sDir2, sTyper) 

HAB hab; /* Anchor-block handle */ 

USHORT usMsgid; /* Message identifier */ 

SHORT sTypel; /* Datatype of message-parameter 1 */ 

SHORT sDirl; /* Direction of message-parameter 1 */ 

SHORT sType2; /* Datatype of message-parameter 2 */ 

SHORT sDir2; /* Direction of message-parameter 2 */ 

SHORT sTyper; /ic Datatype of message reply if/ 

BOOL fSuccess; /ie Success indicator ic/ 


WinRegisterWindowDestroy 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCLJM */ 

BOOL fSuccess = WinRegisterWindowDestroy (hwnd, f Register) 

HWND hwnd; /* Window handle */ 

BOOL fRegister; /if Registration indicator */ 

BOOL fSuccess; /* Success indicator */ 


WinReleaseHook 

^define INCL_WINH00KS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinReleaseHook (hab, hmq, sHook, pAddress, Module) 

HAB hab; /* Anchor-block handle */ 

HMQ hmq; /if Handle of message queue from which the hook is to be released */ 

SHORT sHook; /* Type of hook chain if/ 

PFN pAddress; /* Address of the hook routine */ 

HMODULE Module; /if Module handle if/ 

BOOL fSuccess; /* Success indicator */ 
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WinReleasePS 

#define INCLJ/INWINDOWMGR /* Or use INCLJ/IN or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = WinReleasePS (hps) 

HPS hps; /* Handle of the cache presentation space to release */ 

BOOL fSuccess; /* Success indicator */ 


WinRemovePresParam 

#define INCL_WINSYS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinRemovePresParam (hwnd, idAttrType) 

HWND hwnd; /* Window handle */ 

ULONG idAttrType; /* Attribute type identity */ 

BOOL fSuccess; /* Success indicator */ 


WinRemoveSwitchEntry 

#define INCL_WINSWITCHLIST /* Or use INCLWIN or INCL_PM. Also in COMMON section */ 
USHORT usRetCode = WinRemoveSwitchEntry (hswitchSwitch) 

HSWITCH hswitchSwitch; /* Switch-list (task-list) entry handle */ 

USHORT usRetCode; /* Success indicator */ 


WinScrollWindow 

^define INCL_WINWINDOWMGR /* Or use INCLWIN or INCL_PM. Also in COMMON section */ 

SHORT sComplexity ° WinScrollWindow (hwnd, sDx, sDy, prclScroll, prclClip, hrgnUpdateRgn, 

prcl Update, fsOptions) 

HWND hwnd; /* Window handle */ 

SHORT sDx; /* Amount of horizontal scroll to the right (in device units) */ 

SHORT sDy; /* Amount of vertical scroll upward (in device units) */ 

PRECTL prclScroll; /* Scroll rectangle */ 

PRECTL prclClip; /* Clip rectangle */ 

HRGN hrgnUpdateRgn; /* Update region */ 

PRECTL prcl Update; /* Update rectangle */ 

USHORT fsOptions; /* Scroll options */ 

SHORT sComplexity; /* Complexity of resulting region/error indicator */ 


WinSendDIgltemMsg 

#define INCL_WINDIALOGS /* Or use INCLJMN or INCL_PM */ 

MRESULT mresReply = WinSendDIgltemMsg (hwndDIg, idltem, usMsgid, mpParaml, mpParam2) 

HWND hwndDIg; /* Parent-window handle */ 

USHORT idltem; /* Identity of the child window */ 

USHORT usMsgid; /* Message identity */ 

MPARAM mpParaml; /* Message parameter 1 */ 

MPARAM mpParam2; /* Message parameter 2 */ 

MRESULT mresReply; /* Message-return data */ 
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WinSendMsg 

#define INCL.WINMESSAGEMGR /* Or use INCL.WIN or INCL_PM. Also in COMMON section */ 

MRESULT mresReply = WinSendMsg (hwnd, usMsgid, mpParaml, mpParam2) 

HWND hwnd; /* Window handle */ 

USHORT usMsgid; /* Message identity */ 

MPARAM mpParaml; /* Parameter 1 */ 

MPARAM mpParam2; /* Parameter 2 */ 

MRESULT mresReply; /* Message-return data */ 


WinSetAccelTable 

^define INCL_WINACCELERATORS /* Or use INCL_WIN or INCL.PM */ 

BOOL fSuccess = WinSetAccelTable (hab, haccel Accel, hwndFrame) 

HAB hab; /* Anchor-block handle */ 

HACCEL haccel Accel; /* Accel erator-table handle */ 

HWND hwndFrame; /* Frame-window handle */ 

BOOL fSuccess; /* Success indicator */ 


WinSetActiveWindow 

#define INCL.WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinSetActiveWindow (hwndDeskTop, hwnd) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HWND hwnd; /* Window handle */ 

BOOL fSuccess; /* Active-window-set indicator */ 


WinSetCapture 

#def i ne INCL_WININPUT /* Or use INCLWIN or INCL.PM */ 

BOOL fSuccess = WinSetCapture (hwndDesktop, hwnd) 

HWND hwndDesktop; /* Desktop-window handle, or HWND_DESKTOP */ 

HWND hwnd; /* Handle of the window that is to receive all pointing device messages 

*/ 

BOOL fSuccess; /* Success indicator */ 

WinSetClassMsglnterest 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL.PM */ 

BOOL fSuccess = WinSetClassMsglnterest (hab, pszClassName, usMsgClass, sControl) 

HAB hab; /* Anchor-block handle */ 

PSZ pszClassName; /* Window-class name */ 

USHORT usMsgClass; /* Message class to have interest level set */ 

SHORT sControl; /* Interest identifier for the message class */ 

BOOL fSuccess; /* Interest-changed indicator */ 


WinSetClipbrdData 

#define INCL_WINCLIPBOARD /* Or use INCL_WIN or INCL_PM */ 

BOOL fDataPlaced = WinSetClipbrdData (hab, ulh, usfmt, fsFmtlnfo) 

HAB hab; lie Anchor-block handle */ 

ULONG ulh; /* Handle */ 

USHORT usfmt; /* Format */ 

USHORT fsFmtlnfo; /* Information */ 

BOOL fDataPlaced; /* Data-placed indicator */ 
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WinSetClipbrdOwner 

Idefine INCL_WINCLIPBOARD /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetClipbrdOwner (hab, hwnd) 

HAB hab; /* Anchor-block handle */ 

HWND hwnd; lie Window handle of the new clipboard owner */ 

BOOL fSuccess; /* Success indicator */ 


WinSetClipbrdViewer 

define INCL_WINCLIPBOARD /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetClipbrdViewer (hab, hwndNewClipViewer) 

HAB hab; /* Anchor-block handle ief 

HWND hwndNewClipViewer; /* Window handle of the new clipboard viewer */ 
BOOL fSuccess; lie Success indicator */ 


WinSetCp 

^define INCLJIINCOUNTRY /* Or use INCL_WIN or INCL_PM ie/ 

BOOL fSuccess = WinSetCp (hmq, usCodePage) 

HMQ hmq; /* Message-queue handle */ 

USHORT usCodePage; /* Code page ie/ 

BOOL fSuccess; lie Success indicator */ 


WinSetDIgltemShort 

#define INCL_WINDIALOGS lie Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = WinSetDIgltemShort (hwndDlg, idltem, usValue, fSigned) 

HWND hwndDlg; lie Parent -window handle */ 

USHORT idltem; lie Identity of the child window whose text is to be changed */ 

USHORT usValue; /* Integer value used to generate the dialog item text */ 

BOOL fSigned; /ie Sign indicator */ 

BOOL fSuccess; lie Success indicator ie/ 


WinSetDIgltemText 

#define INCL_WINDIALOGS /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
BOOL fSuccess - WinSetDIgltemText (hwndDlg, idltem, pszText) 

HWND hwndDlg; /* Parent-window handle */ 

USHORT idltem; /* Identity of the child window whose text is to be set */ 

PSZ pszText; lie Source string */ 

BOOL fSuccess; /* Success indicator */ 


WinSetErrorlnfo 

VOID = WinSetErrorlnfo (erridldError, fsOptions, usargs) 

ERROR ID erridldError; fie Error identity to be set ie! 
USHORT fsOptions; /* Options ie! 

USHORT usargs; lie Parameter words */ 
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WinSetFocus 

#define INCLWININPUT /* Or use INCLJIIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinSetFocus (hwndDeskTop, hwndNewFocus) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HWND hwndNewFocus; /* Window handle to receive the focus */ 

BOOL fSuccess; /* Success indicator */ 

WinSetHook 

Idefine INCL_WINH00KS /* Or use INCLJIIN or INCL_PM */ 

BOOL fSuccess = WinSetHook (hab, hmq, sHookType, pHookProc, Module) 

HAB hab; /* Anchor-block handle */ 

HMQ hmq; /* Queue identity */ 

SHORT sHookType; /* Hook chain type */ 

PFN pHookProc; /* Address of the application hook procedure */ 

HMODULE Module; /* Resource identity */ 

BOOL fSuccess; /* Success indicator */ 

WinSetKeyboardStateTable 

Idefine INCL_WININPUT /* Or use INCLJIIN or INCL_PM */ 

BOOL fSuccess = WinSetKeyboardStateTable (hwndDeskTop, abKeyStateTable, fSet) 

HWND hwndDeskTop; /* Desktop-window handle */ 

PBYTE abKeyStateTable; /* Key state table */ 

BOOL fSet; /* Set indicator */ 

BOOL fSuccess; /* Success indicator */ 

WinSetMsglnterest 

Idefine I NC L_W I NMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetMsglnterest (hwnd, usMsgClass, sControl) 

HWND hwnd; /* Window handle */ 

USHORT usMsgClass; /* Message class to have interest level set */ 

SHORT sControl; /* Interest-identifier for the message class */ 

BOOL fSuccess; /* Interest-changed indicator */ 

WinSetMsgMode 

Idefine INCL_WI NMESSAGEMGR /* Or use INCLJIIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinSetMsgMode (hab, pszClassName, sControl) 

HAB hab; /* Anchor block handle */ 

PSZ pszClassName; /* Window class name */ 

SHORT sControl; /* Message mode identifier */ 

BOOL fSuccess; /* Message delay indicator */ 

WinSetMultWindowPos 

Idefine INCLJIINWINDOWMGR /* Or use INCLJIIN or INCL_PM */ 

BOOL fSuccess s WinSetMultWindowPos (hab, aSwp, cCount) 

HAB hab; /* Anchor-block handle */ 

PSWP aSwp; /* Array */ 

USHORT cCount; /* Window count */ 

BOOL fSuccess; /* Positioning success indicator */ 
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WinSetOwner 

#define INCL_WINWINDOWMGR /* Or use INCLJJIN or INCL_PM */ 

BOOL fSuccess = WinSetOwner (hwnd, hwndNewOwner) 

HWND hwnd; /* Window handle whose owner window is to be changed */ 

HWND hwndNewOwner; /* Handle of the new owner */ 

BOOL fSuccess; /* Success indicator */ 


WinSetParent 

Idefine INCLJIINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetParent (hwnd, hwndNewParent, f Redraw) 

HWND hwnd; /* Window handle */ 

HWND hwndNewParent; /* New parent window handle */ 

BOOL f Redraw; /* Redraw indicator */ 

BOOL fSuccess; /* Parent-changed indicator */ 


WinSetPointer 

#define INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetPointer (hwndDeskTop, hptrNewPointer) 

HWND hwndDeskTop; /* Desktop-window handle */ 

HPOINTER hptrNewPointer; /* New pointer handle */ 

BOOL fSuccess; /* Pointer-updated indicator */ 


WinSetPointerPos 

#define INCLJrfINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetPointerPos (hwndDeskTop, sx, sy) 

HWND hwndDeskTop; /* Desktop-window handle */ 

SHORT sx; /* x position of pointer in screen coordinates */ 

SHORT sy; /* y position of pointer in screen coordinates */ 

BOOL fSuccess; /* Pointer position updated indicator */ 

WinSetPresParam 

^define INCLJJINSYS /* Or use INCLJIIN or INCL.PM */ 

BOOL fSuccess = WinSetPresParam (hwnd, idAttrType, cbAttrValueLen, pAttrValue) 

HWND hwnd; /* Window handle */ 

ULONG idAttrType; /* Attribute type identity */ 

ULONG cbAttrValueLen; /* Byte count of the data passed in the AttrValue parameter */ 
PVOID pAttrValue; /* Attribute value */ 

BOOL fSuccess; /* Success indicator */ 
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WinSetRect 

fdefine I NCL_WI NRECTANGLES /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetRect (hab, prclrect, sLeft, sBottom, sRight, sTop) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclrect; /* Rectangle to be updated */ 

SHORT sLeft; /* Left edge of rectangle */ 

SHORT sBottom; /* Bottom edge of rectangle */ 

SHORT sRight; /* Right edge of rectangle */ 

SHORT sTop; /* Top edge of rectangle */ 

BOOL fSuccess; /* Success indicator */ 


WinSetRectEmpty 

#define INCL_WINRECTANGLES /* Or use INCLJrfIN or INCL_PM */ 

BOOL fSuccess = WinSetRectEmpty (hab, prclrect) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclrect; /* Rectangle to be set empty */ 

BOOL fSuccess; /* Success indicator */ 

WinSetSynchroMode 

#define INCLJ/INMESSAGEMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section it/ 

BOOL fSuccess = WinSetSynchroMode (hab, sMode) 

HAB hab; /* Anchor-block handle */ 

SHORT sMode; /* Synchronization mode */ 

BOOL fSuccess; /* Success indicator it/ 

WinSetSysColors 

#define INCL.WINSYS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess » WinSetSysColors (hwndDeskTop, flOptions, ulFormat, IStart, ulTablen, 

al Table) 

HWND hwndDeskTop; /it Desktop-window handle */ 

ULONG flOptions; /it Options it/ 

ULONG ulFormat; /it Format of entries in the table, as follows */ 

LONG IStart; /* Starting system color index it/ 

ULONG ulTablen; fit Number of elements */ 

PLONG al Table; /* Table it/ 

BOOL fSuccess; /* Success indicator */ 

WinSetSysModalWindow 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCLJ>M */ 

BOOL fSuccess = WinSetSysModalWindow (hwndDesktop, hwnd) 

HWND hwndDesktop; /it Desktop-window handle, or HWND_DESKTOP */ 

HWND hwnd; /* Handle of window to become system-modal window */ 

BOOL fSuccess; /* Success indicator */ 
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WinSetSysValue 

#define INCLJIINSYS /* Or use INCLJIIN or INCL_PM */ 

BOOL fSuccess = WinSetSysValue (hwndDeskTop, sValueid, lValue) 

HWND hwndDeskTop; /* Desktop-window handle */ 

SHORT sValueid; /* System-value identity */ 

LONG lValue; /* System value */ 

BOOL fSuccess; /* Value-set indicator */ 


WinSetWindowBits 

#define INCLJIINWINDOWMGR /* Or use INCLJIIN or INCL_PM */ 
BOOL fSuccess = WinSetWindowBits (hwnd, sb, flData, f 1 Mask) 
HWND hwnd; /* Window handle */ 

SHORT sb; /* Zero-based index of the value to be set */ 

ULONG flData; /* Bit data to store in the window words */ 

ULONG f 1 Mask; /* Bits to be written indicator */ 

BOOL fSuccess; /* Success indicator */ 


WinSetWindowPos 

#define I NC L_WI NWI NDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetWindowPos (hwnd, hwndBehind, sx, sy, sex, scy, fsOptions) 

HWND hwnd; /* Window handle */ 

HWND hwndBehind; /* Relative window-placement order */ 

SHORT sx; /* Window position, x coordinate */ 

SHORT sy; /* Window position, y coordinate */ 

SHORT sex; /* Window size */ 

SHORT scy; /* Window size */ 

USHORT fsOptions; /* Window-positioning options */ 

BOOL fSuccess; /* Repositioning indicator */ 


WinSetWindowPtr 

^define I NCL_WI NWI NDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetWindowPtr (hwnd, sb, pp) 

HWND hwnd; /* Window handle */ 

SHORT sb; /* Zero-based index into the window words */ 

PVOID pp; /* Pointer value to store in the window words */ 

BOOL fSuccess; /* Success indicator */ 


WinSetWindowText 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fResult = WinSetWindowText (hwnd, pszString) 

HWND hwnd; /* Window handle */ 

PSZ pszString; /* Window text */ 

BOOL fResult; /* Text-updated indicator */ 
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WinSetWindowULong 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL f Success = WinSetWindowULong (hwnd, sb, ulData) 

HWND hwnd; /* Window handle */ 

SHORT sb; /* Zero-based index of the value to be set */ 

ULONG ulData; /* Unsigned, long integer value to store in the window words */ 

BOOL fSuccess; /* Success indicator */ 


WinSetWindowUShort 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinSetWindowUShort (hwnd, sb, usData) 

HWND hwnd; /* Window handle */ 

SHORT sb; /* Zero-based index of the value to be set */ 

USHORT usData; /* Unsigned, short integer value to store in the window words */ 

BOOL fSuccess; /* Success indicator */ 


WinShowCursor 

#define INCL_WINCURSOR$ /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
BOOL fSuccess = WinShowCursor (hwnd, fShow) 

HWND hwnd; /* Handle of window to which the cursor belongs */ 

BOOL fShow; /* Show indicator ie/ 

BOOL fSuccess; /* Success indicator */ 


WinShowPointer 

#define INCL_WINPOINTERS /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinShowPointer (hwndDeskTop, fShow) 

HWND hwndDeskTop; /* Desktop-window handle ie! 

BOOL fShow; /* Level -update indicator */ 

BOOL fSuccess; /* Display-level -updated indicator */ 

WinShowTrackRect 

^define INCL_WINTRACKRECT /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinShowTrackRect (hwnd, fShow) 

HWND hwnd; /* Window handle */ 

BOOL fShow; /* Show indicator */ 

BOOL fSuccess; lie Success indicator */ 

WinShowWindow 

^define INCL_WINWINDOWMGR lie Or use INCLWIN or INCL_PM. Also in COMMON section */ 

BOOL fSuccess = WinShowWindow (hwnd, fNewVisibi 1 ity) 

HWND hwnd; lie Window handle */ 

BOOL fNewVisibility; /* New visibility state ie/ 

BOOL fSuccess; lie Visibility changed indicator ie/ 
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WinStartTimer 

#define INCL.WINTIMER /* Or use INCL.WIN or INCL_PM */ 

USHORT usRet = WinStartTimer (hab, hwnd, idTimer, usTimeout) 

HAB hab; /* Anchor-block handle */ 

HWND hwnd; /* Window handle that is part of the timer identification */ 

USHORT idTimer; /* Timer identifier */ 

USHORT usTimeout; /* Delay time in milliseconds */ 

USHORT usRet; /* Return code */ 


WinStopTimer 

#define INCL_WINTIMER /* Or use INCL.WIN or INCL.PM */ 

BOOL fSuccess = WinStopTimer (hab, hwnd, usTimer) 

HAB hab; /* Anchor-block handle */ 

HWND hwnd; /* Window handle */ 

USHORT usTimer; /* Timer identifier */ 

BOOL fSuccess; /* Success indicator */ 


WinSubclassWindow 

fdefine INCL.WINWINDOWMGR /* Or use INCL.WIN or INCL.PM */ 

PFNWP pOldWindowProc = WinSubclassWindow (hwnd, pNewWindowProc) 

HWND hwnd; /* Handle of window that is being subclassed */ 

PFNWP pNewWindowProc; /* New window procedure */ 

PFNWP pOldWindowProc; /* Old window procedure */ 


WinSubstituteStrings 

#define INCL.WINDIALOGS /* Or use INCL.WIN or INCL.PM */ 

SHORT sDestRet = WinSubstituteStrings (hwnd, pszSrc, sDestMax, pszDest) 

HWND hwnd; /* Handle of window that processes the call */ 

PSZ pszSrc; /* Source string */ 

SHORT sDestMax; /* Maximum number of characters returnable */ 

PSZ pszDest; /* Resultant string */ 

SHORT sDestRet; /* Actual number of characters returned */ 

WinSubtractRect 

#define INCL.WINRECTANGLES /* Or use INCL.WIN or INCL.PM */ 

BOOL fNonempty = WinSubtractRect (hab, prclDest, prclSrcl, prclSrc2) 

HAB hab; lie Anchor-block handle */ 

PRECTL prclDest; /* Result */ 

PRECTL prclSrcl; /* First source rectangle */ 

PRECTL prclSrc2; /* Second source rectangle */ 

BOOL fNonempty; /* Not-empty indicator */ 

WinSwitchToProgram 

#define INCL.WINSWITCHLIST /* Or use INCL.WIN or INCL.PM */ 

USHORT usRetCode = WinSwitchToProgram (hswitchSwHandle) 

HSWITCH hswitchSwHandle; /* Switch list entry handle of program to be activated */ 
USHORT usRetCode; /* Return code */ 
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WinTerminate 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM. Also in COMMON section */ 
BOOL fTerminated = WinTerminate (hab) 

HAB hab; /* Anchor-block handle */ 

BOOL fTerminated; /* Termination indicator */ 

WinTerminateApp 

#defi ne INCLJJINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL f Success = WinTerminateApp (happ) 

HAPP happ; /* Application handle */ 

BOOL f Success; /* Success indicator */ 

WinThrow 

#define INCLJ/INCATCHTHROW /* Or use INCLJ/IN or INCL_PM */ 

VOID = WinThrow (pctchbfCatchBuf, sThrowBack) 

PCATCHBUF pctchbfCatchBuf; /* Saved execution-environment buffer */ 

SHORT sThrowBack; /* Return value */ 

WinTrackRect 

#define INCL_WINTRACKRECT /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinTrackRect (hwnd, hps, ptiTrackinfo) 

HWND hwnd; /* Window handle where tracking is to take place */ 

HPS hps; /* Presentation-space handle */ 

PTRACKINFO ptiTrackinfo; /* Track information it/ 

BOOL fSuccess; /* Success indicator */ 

WinTranslate Accel 

#define INCL_WINACCELERATORS /* Or use INCLJ/IN or INCL_PM */ 

BOOL fSuccess = WinTranslateAccel (hab* hwnd, haccel Accel , pQmsg) 

HAB hab; /* Anchor-block handle */ 

HWND hwnd; /* Destination window */ 

HACCEL haccelAccel; /* Accelerator-table handle */ 

PQMSG pQmsg; /* Message to be translated it/ 

BOOL fSuccess; /it Success indicator */ 

WinUnionRect 

#define INCL_WINRECTANGLES /it Or use INCLJ/IN or INCL_PM */ 

BOOL f Nonempty = WinUnionRect (hab, prclDest, prclSrcl, prclSrc2) 

HAB hab; /* Anchor-block handle */ 

PRECTL prclDest; /* Bounding rectangle */ 

PRECTL prclSrcl; /* First source rectangle */ 

PRECTL prclSrc2; /it Second source rectangle */ 

BOOL f Nonempty; /it Non-empty indicator it/ 
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WinUpdateWindow 

#def i ne INCLJIINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL f Success s WinUpdateWindow (hwnd) 

HWND hwnd; /* Window handle */ 

BOOL fSuccess; /* Window-updated indicator */ 


WinUpper 

#define INCLWINCOUNTRY /* Or use INCLJIIN or INCL_PM */ 

USHORT usRetLen = WinUpper (hab, usCodepage, usCountry, pszString) 

HAB hab; /* Anchor-block handle */ 

USHORT usCodepage; /* Code page */ 

USHORT usCountry; /* Country code */ 

PSZ pszString; /* String to be converted to uppercase */ 

USHORT usRetLen; /* Length of converted string */ 


WinUpperChar 

^define INCLJUNCQUNTRY /* Or use INCL_WIN or INCL_PM */ 

USHORT usOutchar = WinUpperChar (hab, usCodepage, usCountry, uslnchar) 

HAB hab; /* Anchor-block handle */ 

USHORT usCodepage; /* Code page */ 

USHORT usCountry; /* Country code */ 

USHORT uslnchar; /* Character to be translated to uppercase */ 

USHORT usOutchar; /* Translated character */ 


WinValidateRect 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinValidateRect (hwnd, prclRect, find udeCl ippedChildren) 

HWND hwnd; /* Handle of window whose update region is changed */ 

PRECTL prclRect; /* Rectangle to be subtracted from the window's update 

region */ 

BOOL find udeCl ippedChildren; /* Validation-scope indicator */ 

BOOL fSuccess; /* Success indicator */ 


WinValidateRegion 

fdefine INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM 

BOOL fSuccess = WinValidateRegion (hwnd, hrgn, find udeCl ippedChildren) 

HWND hwnd; /* Handle of window whose update region is changed */ 

HRGN hrgn; /* Handle of subtracted region */ 

BOOL find udeCl ippedChildren; /* Validation-scope indicator */ 

BOOL fSuccess; /* Success indicator */ 


WinWaitMsg 

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN or INCL_PM */ 

BOOL fSuccess = WinWaitMsg (hab, usFirst, usLast) 

HAB hab; /* Anchor-block handle */ 

USHORT usFirst; /* First message identity */ 

USHORT usLast; /* Last message identity */ 

BOOL fSuccess; /* Success indicator */ 
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WinWindowFromDC 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 
HWND hwnd = WinWindowFromDC (hdc) 

HOC hdc; /* Device-context handle */ 

HWND hwnd; /* Window handle it/ 


WinWindowFromID 

#define INCL_WINWINDOWMGR /* Or use INCL_WIN or INCL_PM */ 

HWND hwnd = WinWindowFromID (hwndParent, usidentifier) 

HWND hwndParent; /* Parent-window handle it/ 

USHORT usidentifier; /it Identity of the child window */ 

HWND hwnd; /* Window handle */ 


WinWindowFromPoint 

#define INCL_WINWINDOWMGR /it Or use INCL_WIN or INCL_PM */ 

HWND hwndFound = WinWindowFromPoint (hwndParent, pptlPoint, fEnumChildren, fLock) 

HWND hwndParent; /it Window handle whose child windows are to be tested it/ 

PPOINTL pptlPoint; /it The point to be tested */ 

BOOL fEnumChildren; /* Test control */ 

BOOL fLock; /it Lock control */ 

HWND hwndFound; /* Window handle beneath Point */ 


WinWriteProfileData 

^define INCL^WINSHELLDATA /* Or use INCL_WIN or INCL_PM it/ 

BOOL f Success = WinWriteProfileData (hab, pszAppName, pszKeyName, pValue, usSize) 

HAB hab; /* Anchor-block handle it/ 

PSZ pszAppName; /it Text string */ 

PSZ pszKeyName; /* Text string */ 

PVOID pValue; /* Value data it/ 

USHORT usSize; /it Size of value data it/ 

BOOL f Success; /it Success indicator */ 


WinWriteProfileString 

#define INCL_WINSHELLDATA /it Or use INCL_WIN or INCL_PM it/ 

BOOL fSuccess = WinWriteProfileString (hab, pszAppName, pszKeyName, pszValue) 

HAB hab; /* Anchor block handle */ 

PSZ pszAppName; /it Text string it/ 

PSZ pszKeyName; /it Text string it/ 

PSZ pszValue; /it Text string it/ 

BOOL fSuccess; /it Success indicator */ 
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Chapter 10. Functions Supplied by Applications 


DialogProc 

MRESULT mresReply = DialogProc (hwnd, usmsg, mpParaml, mpParam2) 

HWND hwnd; /* Handle of the window to which the message applies */ 

USHORT usmsg; /* Message identity */ 

MPARAM mpParaml; /* Message parameter 1 */ 

MPARAM mpParam2; /* Message parameter 2 */ 

MRESULT mresReply; /* Message-return data */ 


WndProc 

MRESULT mresReply = WndProc (hwnd, usmsg, mpParaml, mpParam2) 

HWND hwnd; /* Window handle */ 

USHORT usmsg; /* Message identity */ 

MPARAM mpParaml; /* Message parameter 1 */ 

MPARAM mpParam2; /* Message parameter 2 */ 

MRESULT mresReply; /* Message-return data */ 


CodePageChangeHook 

VOID return = CodePageChangeHook (hmq, usOldCodePage, usNewCodePage) 

HMQ hmq; /* Message-queue handle */ 

USHORT usOldCodePage; /* Previous code page */ 

USHORT usNewCodePage; /* New code page */ 

HelpHook 

BOOL f = HelpHook (hab, sMode, sTopic, sSubTopic, prclPosition) 

HAB hab; /* Anchor-block handle */ 

SHORT sMode; /* Help mode */ 

SHORT sTopic; /* Topic identifier */ 

SHORT sSubTopic; /* Subtopic identifier */ 

PRECTL prclPosition; /* Rectangle */ 

BOOL f; /* Indicator as to whether next hook in the chain is called */ 


InputHook 

BOOL fProcessed = InputHook (hab, pQmsg, fsOptions) 

HAB hab; /* Anchor-block handle */ 

PQMSG pQmsg; /it A QMSG data structure */ 

USHORT fsOptions; /it Message removal options it/ 

BOOL fProcessed; /it Processed indicator */ 


JournalPlaybackHook 

LONG ITime = JournalPlaybackHook (hab, pqmsg, fSkip) 

HAB hab; /it Anchor-block handle */ 

PQMSG pqmsg; /it Data structure where the message to be played back is returned it/ 
BOOL fSkip; /it Indicator as to whether the next message should be played back */ 

LONG ITime; /* Waiting time */ 
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JournalRecordHook 

BOOL fSuccess = JournalRecordHook (hab, pqmsg) 

HAB hab; /★ Anchor-block handle */ 

PQMSG pqmsg; /* Data structure that contains the message to be recorded */ 

BOOL fSuccess; /* The return value from this hook is ignored */ 

LoaderHook 

BOOL fProcessed = LoaderHook (hab, sContext, pszlibname, phlibLibhandle, pszprocname, 

pwndproc, pf Success) 

HAB hab; /* Anchor-block handle */ 

SHORT sContext; /* Origin of call to hook */ 

PSZ pszlibname; /* Library name */ 

PHLIB phlibLibhandle; /* Library handle */ 

PSZ pszprocname; /* Procedure name */ 

PFN pwndproc; /* Window procedure identifier */ 

PBOOL pfSuccess; /* Success indicator */ 

BOOL fProcessed; /* Processing indicator */ 

MsgCtIHook 

BOOL fProcessed « MsgCtIHook (hab, sContext, hwnd, pszClassName, usMsgClass, sControl, 

pfSuccess) 

HAB hab; /* Anchor-block handle */ 

SHORT sContext; /* Origin of call to hook */ 

HWND hwnd; /* Window handle */ 

PSZ pszClassName; /* Window class name */ 

USHORT usMsgClass; /* Message class */ 

SHORT sControl; /* Control setting */ 

PBOOL pfSuccess; /* Success indicator */ 

BOOL fProcessed; /* Processing indicator */ 

MsgFilterHook 

BOOL fProcessed = MsgFilterHook (hab, pQmsg, usContext) 

HAB hab; /* Anchor-block handle */ 

PQMSG pQmsg; /* A queue message data structure */ 

USHORT usContext; /* Context in which the hook has been called */ 

BOOL fProcessed; /* Processed indicator */ 

RegisterUserMsg 

BOOL fProcessed = RegisterUserMsg (hab, sContext, usMsgid, sTypel, sDirl, sType2, sDir2, 

sTyper, sCount, asTypes, pfSuccess) 

HAB hab; /* Anchor-block handle */ 

SHORT sContext; /* Origin of call to hook */ 

USHORT usMsgid; /* Message identifier */ 

SHORT sTypel; /* Data type of message-parameter 1 */ 

SHORT sDirl; /* Direction of message-parameter 1 */ 

SHORT sType2; /* Data type of message-parameter 2 */ 

SHORT sDir2; /* Direction of message-parameter 2 */ 

SHORT sTyper; /* Data type of message reply */ 

SHORT sCount; /* Number of elements */ 

PSHORT asTypes; /* Data types of structure components */ 

PBOOL pfSuccess; /* Success indicator */ 

BOOL fProcessed; /* Processing indicator */ 


10-2 PM C/2 Bindings Reference 



SendMsgHook 

VOID return = SendMsgHook (hab, psmhssmh, flnterTask) 


HAB 

PSMHSTRUCT 

BOOL 


hab; 

psmhssmh; 

flnterTask; 


/* Anchor-block handle */ 

/* Send message hook structure */ 
/* Intertask indicator */ 
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GpiSetPS 4-39 
GpiSetRegion 4-39 
GpiSetSegmentAttrs 4-39 
GpiSetSegmentPriority 4-39 
GpiSetSegmentTransformMatrix 4-39 
GpiSetStopDraw 4-40 
GpiSetTag 4-40 


GpiSetViewingLimits 4-40 
GpiSetViewingTransformMatrix 4-40 
GpiStrokePath 4-40 
GpiTranslate 4-40 
GpiUnloadFonts 4-41 
GpiUnrealizeColorTable 4-41 
GpiWCBitBIt 4-41 
GRADIENT 2-8 
GRADIENTL 2-8 


H 

HAB 2-8 
HACCEL 2-8 
HANDLE 2-8 
HAPP 2-8 
HATOMTBL 2-8 
HBITMAP 2-8 
HCINFO 2-8 
HDC 2-8 

helper macros 1-2 

HelpHook 10-1 

HELPINIT 2-9 

HELPSUBTABLE 2-9 

HELPSUBTABLEITEM 2-1 0 

HELPTABLE 2-10 

HENUM 2-10 

HHEAP 2-10 

HINI 2-10 

HUB 2-10 

HMF 2-10 

HMODULE 2-10 

HMQ 2-10 

HPOINTER 2-10 

HPROC 2-10 

HPROG ARRAY 2-11 

HPROGRAM 2-11 

HPS 2-11 

HRGN 2-11 

HSEM 2-11 

HSPL 2-11 

HSWITCH 2-11 

HVPS 2-11 

HWND 2-11 


I 

IBM C/2 data types 1-2 
IDENTITY 2-11 
IDENTITY4 2-11 
IMAGEBUNDLE 2-11 
implicit pointer data types 1-5 
INDEX2 2-11 
InputHook 10-1 
IPT 2-11 


J 

JournalPlaybackHook 10-1 
JournalRecordHook 10-2 


K 

kerning 2-11 
KERNINGPAIRS 2-11 
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L 

LENGTH2 2-11 
LENGTH4 2-11 
LHANDLE 2-12 
LINEBUNDLE 2-12 
LoaderHook 10-2 
LONG 2-12 


M 

mapping metalanguage data types to C 1-5 

MARGSTRUCT 2-12 

MARKERBUNDLE 2-12 

MATRIX 2-12 

MATRIXLF 2-13 

MENUITEM 2-13 

metalanguage data types 

mapping to C data types 1-5 
MLECTLDATA 2-13 
MLE_SE ARCH DATA 2-13 
MPARAM 2-14 
MQINFO 2-14 
MRESULT 2-14 
MsgCtIHook 10-2 
MsgFilterHook 10-2 
MT 2-13 
MTI 2-14 


N 

NPBYTE 2-14 


0 

OFFSET2B 2-14 
OVERFLOW 2-14 
OWNERITEM 2-15 


P 

PARAM 2-15 
PBUNDLE 2-15 
PBYTE 2-15 
PCH 2-15 

PDEVOPENDATA 2-15 
PFFDESCS 2-15 
PFN 2-15 
PFNWP 2-15 
PIBSTRUCT 2-15 
Piclchg 5-1 
PicPrint 5-1 
PID 2-16 
PIX 2-16 
PMPARAM 2-16 
PMRESULT 2-16 
POINT 2-16 
POINTERINFO 2-16 
POINTL 2-16 
POINTS 2-16 
PQM OPEN DATA 2-16 
PRESDATA 2-17 
PRESPARAMS 2-17 
PrfAddProgram 6-1 
PrfChangeProgram 6-1 
PrfCloseProfile 6-1 


PrfCreateGroup 6-1 
PrfDestroyGroup 6-1 
PrfOpenProfile 6-1 
PRFPROFILE 2-17 
PrfQueryDefinition 6-2 
PrfQueryProfile 6-2 
PrfQueryProfileData 6-2 
PrfQueryProfilelnt 6-2 
PrfQueryProfileSize 6-2 
PrfQueryProfileString 6-3 
PrfQueryProgramCategory 6-3 
PrfQueryProg ram Handle 6-3 
PrfQueryProgramTitles 6-3 
PrfRemoveProgram 6-3 
PrfReset 6-4 
PrfWriteProfileData 6-4 
PrfWriteProfileString 6-4 
PROC 2-17 
PROGCATEGORY 2-17 
PROGDETAILS 2-17 
PROGRAMENTRY 2-17 
PROGTITLE 2-17 
PROGTYPE 2-18 
PROPERTY2 2-18 
PROPERTY4 2-18 
PSZ 2-18 
PVOID 2-18 


Q 

QMOPENDATA 2-18 
QMSG 2-18 


R 

RECT 2-18 
RECTL 2-18 
RegisterUserMsg 10-2 
RESID 2-18 
RGB 2-18 
RGNRECT 2-19 
ROF 2-19 
ROL 2-19 


S 

SBCDATA 2-19 
SEGOFF 2-19 
SendMsgHook 10-3 
SF ACTORS 2-19 
SHORT 2-19 
SIZEF 2-19 
SIZEL 2-19 
SIZEROF 2-19 
SIZEROL 2-19 
SMHSTRUCT 2-20 
SpIQmAbort 7-1 
SpIQmClose 7-1 
SpIQmEndDoc 7-1 
SpIQmOpen 7-1 
SpIQmStartDoc 7-1 
SpIQm Write 7-1 
SpIQpInstall 7-2 
SpIQpQueryDt 7-2 
STORAGE 2-20 

storage mapping of data types 1-5 
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STR 2-20 
STRCOND 2-20 
STRL 2-20 
STRLLIST 2-20 
STR 16 2-20 
STR32 2-20 
STR64 2-20 
STR8 2-20 
SWBLOCK 2-20 
SWCNTRL 2-20 
SWENTRY 2-21 
SWP 2-21 
SZ 2-21 


T 

TID 2-21 
TIME 2-21 
TRACKINFO 2-21 


U 

UCHAR 2-21 
ULONG 2-21 
USERBUTTON 2-21 
USHORT 2-21 


V 

Vlo Associate 8-1 
VioCreateLogFont 8-1 
VioCreatePS 8-1 
VioDeleteSetld 8-1 
VioDestroyPS 8-1 
VIOFONTCELLSIZE 2-22 
VioGetDeviceCellSize 8-2 
VioGetOrg 8-2 
VioQueryFonts 8-2 
VioQuerySetlds 8-2 
VioSetDeviceCellSize 8-2 
VioSetOrg 8-3 
VioShowPS 8-3 
VIOSIZECOUNT 2-22 
VOID 2-22 


W 

WIDTH4 2-22 
WinAddAtom 9-1 
WinAddProgram 9-1 
WinAddSwitchEntry 9-1 
WinAlarm 9-1 
WinAllocMem 9-1 
WinAssociateHelpInstance 9-1 
WinAvailMem 9-2 
WinBeginEnumWindows 9-2 
WinBeg in Paint 9-2 
WinBroadcastMsg 9-2 
WinCalcFrameRect 9-2 
WinCallMsgFilter 9-2 
WinCancelShutdown 9-3 
WinCatch 9-3 
WinChangeSwitchEntry 9-3 
WinCloseClipbrd 9-3 
WinCompareStrings 9-3 
WinCopyAccelTable 9-3 


WinCopyRect 9-4 
WinCpTranslateChar 9-4 
WinCpTranslateString 9-4 
WinCreateAccelTable 9-4 
WinCreateAtomTable 9-4 
WinCreateCursor 9-5 
WinCreateDlg 9-5 
WinCreateFrameControls 9-5 
WinCreateGroup 9-5 
WinCreateHeap 9-6 
WinCreateHelpInstance 9-6 
WinCreateHelpTable 9-6 
WinCreateMenu 9-6 
WinCreateMsgQueue 9-6 
WinCreatePointer 9-7 
WinCreatePointerlndirect 9-7 
WinCreateStdWindow 9-7 
WinCreateSwitchEntry 9-7 
WinCreateWindow 9-8 
WinDdelnitiate 9-8 
WinDdePostMsg 9-8 
WinDdeRespond 9-8 
WinDefAVioWindowProc 9-9 
WinDefDIgProc 9-9 
WinDefWindowProc 9-9 
WinDeleteAtom 9-9 
WinDeleteLibrary 9-9 
WinDeleteProcedure 9-9 
Win Destroy AccelTable 9-10 
WinDestroyAtomTable 9-10 
WinDestroyCursor 9-10 
WinDestroyHeap 9-10 
WinDestroyHelpInstance 9-10 
WinDestroyMsgQueue 9-10 
WinDestroyPointer 9-10 
WinDestroyWindow 9-11 
WinDismissDIg 9-11 
WinDispatchMsg 9-11 
WinDIgBox 9-11 
WinDrawBitmap 9-11 
WinDrawBorder 9-12 
WinDrawPointer 9-12 
WinDrawText 9-12 
WinEmptyClipbrd 9-12 
WinEnablePhysInput 9-12 
WinEnableWindow 9-13 
WinEnableWindowUpdate 9-13 
WinEndEnumWindows 9-13 
WinEndPaint 9-13 
WinEnumClipbrdFmts 9-13 
WinEnumDIgltem 9-13 
WinEqualRect 9-14 
WinExcludeUpdateRegion 9-14 
WinFillRect 9-14 
WinFindAtom 9-14 
WinFlashWindow 9-14 
WinFocusChange 9-14 
WinFreeErrorlnfo 9-15 
WinFreeMem 9-15 
WinGetClipPS 9-15 
WinGetCurrentTime 9-15 
WinGetDIgMsg 9-15 
WinGetErrorlnfo 9-15 
WinGetKeyState 9-15 
WinGetLastError 9-16 
WinGetMinPosition 9-16 
WinGetMsg 9-16 
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WinGetNextWindow 9-16 
WinGetPhysKeyState 9-16 
WinGetPS 9-16 
WinGetScreenPS 9-17 
WinGetSysBitmap 9-17 
WinlnflateRect 9-17 
Winlnitialize 9-17 
WinlnSendMsg 9-17 
WinlnstStartApp 9-17 
WinlntersectRect 9-18 
WinlnvalidaleRect 9-18 
WinlnvalidateRegion 9-18 
WinlnvertRect 9-18 
WinlsChild 9-18 
WinlsRectEmpty 9-18 
WinlsThreadActive 9-19 
WinlsWindow 9-19 
WinlsWindowEnabled 9-19 
WinlsWindowShowing 9-19 
WinlsWindowVisible 9-19 
WinLoadAccelTable 9-19 
WinLoadDIg 9-20 
WinLoadHelpTable 9-20 
WinLoadLibrary 9-20 
WinLoadMenu 9-20 
WinLoadPointer 9-20 
WinLoadProcedure 9-21 
WinLoadString 9-21 
WinLockHeap 9-21 
WinLockVisRegions 9-21 
WinLockWindow 9-21 
WinLockWindowUpdate 9-21 
WinMakePoints 9-22 
WinMakeRect 9-22 
WinMapDIgPoints 9-22 
WinMapWindowPoints 9-22 
Win Message Box 9-22 
WinMsgMuxSemWait 9-23 
WinMsgSemWait 9-23 
WinMultWindowFromlDs 9-23 
WinNextChar 9-23 
W inOffset Rect 9-23 
WinOpenClipbrd 9-23 
WinOpenWindowDC 9-24 
WinPeekMsg 9-24 
WinPostMsg 9-24 
WinPostQueueMsg 9-24 
WinPrevChar 9-24 
WinProcessDIg 9-24 
WinPtlnRect 9-25 
WinQueryAccelTable 9-25 
WinQueryActiveWindow 9-25 
WinQueryAnchorBlock 9-25 
WinQueryAtomLength 9-25 
WinQueryAtomName 9-25 
WinQueryAtomllsage 9-26 
WinQueryCapture 9-26 
WinQueryClassInfo 9-26 
WinQueryClassName 9-26 
WinQueryClipbrdData 9-26 
WinQueryClipbrdFmtlnfo 9-26 
WinQueryClipbrdOwner 9-27 
WinQueryClipbrdViewer 9-27 
WinQueryCp 9-27 
WinQueryCpList 9-27 
WinQueryCursorlnfo 9-27 
WinQueryDefinition 9-27 


WinQueryDesktopWindow 9-28 
WinQueryDIgltemShort 9-28 
WinQueryDIgltemText 9-28 
WinQueryDIgltemTextLength 9-28 
WinQueryFocus 9-28 
WinQueryHelpInstance 9-28 
WinQueryMsgPos 9-29 
WinQueryMsgTime 9-29 
WinQueryObjectWindow 9-29 
WinQueryPointer 9-29 
WinQueryPointerlnfo 9-29 
WinQueryPointerPos 9-29 
WinQueryPresParam 9-30 
WinQueryProfileData 9-30 
WinQueryProfilelnt 9-30 
WinQueryProfileSize 9-30 
WinQueryProfileString 9-31 
WinQueryProgramTitles 9-31 
WinQueryQueuelnfo 9-31 
WinQueryQueueStatus 9-31 
WinQuerySessionTitle 9-31 
WinQuerySwitchEntry 9-32 
WinQuerySwitchHandle 9-32 
WinQuerySwitchList 9-32 
WinQuerySysColor 9-32 
WinQuerySysModalWindow 9-32 
WinQuerySysPointer 9-32 
WinQuerySystemAtomTable 9-33 
WinQuerySysValue 9-33 
WinQueryTaskSizePos 9-33 
WinQueryTaskTitle 9-33 
WinQueryUpdateRect 9-33 
WinQueryUpdateRegion 9-33 
WinQueryVersion 9-33 
WinQueryWindow 9-34 
WinQueryWindowDC 9-34 
WinQueryWindowLockCount 9-34 
WinQueryWindowPos 9-34 
WinQueryWindowProcess 9-34 
WinQueryWindowPtr 9-34 
WinQueryWindowRect 9-35 
WinQueryWindowText 9-35 
WinQueryWindowTextLength 9-35 
WinQueryWindowllLong 9-35 
WinQueryWindowUShort 9-35 
WinReallocMem 9-35 
WinRegisterClass 9-36 
Win Reg isterUser Datatype 9-36 
WinRegisterUserMsg 9-36 
WinRegisterWindowOestroy 9-36 
WinReleaseHook 9-36 
WinReleasePS 9-37 
WinRemovePresParam 9-37 
WinRemoveSwitchEntry 9-37 
WinScrollWindow 9-37 
WinSendDIgltemMsg 9-37 
WinSendMsg 9-38 
W inSet AccelTable 9-38 
WinSetActive Window 9-38 
WinSetCapture 9-38 
WinSetClassMsglnterest 9-38 
WinSetClipbrdData 9-38 
WinSetClipbrdOwner 9-39 
WinSetClipbrdViewer 9-39 
WinSetCp 9-39 
WinSetDIgltemShort 9-39 
WinSetDIgltemText 9-39 
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WinSetErrorlnfo 9-39 
WinSetFocus 9-40 
WinSetHook 9-40 
WinSetKeyboardStateTable 9-40 
WinSetMsglnterest 9-40 
WinSetMsgMode 9-40 
WinSetMultWindowPos 9-40 
WinSetOwner 9-41 
WinSetParent 9-41 
WinSetPointer 9-41 
WinSetPointerPos 9-41 
WinSetPresParam 9-41 
WinSetRect 9-42 
WinSetRectEmpty 9-42 
WinSetSynchroMode 9-42 
WinSetSysColors 9-42 
WinSetSysModalWindow 9-42 
WinSetSysValue 9-43 
WinSetWindowBits 9-43 
WinSetWindowPos 9-43 
WinSetWindowPtr 9-43 
WinSetWindowText 9-43 
WinSetWindowULong 9-44 
WinSetWindowUShort 9-44 
WinShowCursor 9-44 
WinShowPointer 9-44 
WinShowTrackRect 9-44 
WinShowWindow 9-44 
WinStartTimer 9-45 
WinStopTimer 9-45 
WinSubclassWindow 9-45 
WinSubstituteStrings 9-45 
WinSubtractRect 9-45 
WinSwitchToProgram 9-45 
WinTerminate 9-46 
WinTerminateApp 9-46 
WinThrow 9-46 
Wi nT rack Rect 9-46 
WinTrans late Accel 9-46 
WinUnionRect 9-46 
WinllpdateWindow 9-47 
Winllpper 9-47 
WinUpperChar 9-47 
WinValidateRect 9-47 
WinValidateRegion 9-47 
WinWaitMsg 9-47 
WinWindowFromDC 9-48 
WlnWIndowFromlD 9-48 
WinWIndowFromPoInt 9-48 
WinWriteProfileData 9-48 
WinWriteProfileString 9-48 
WNDPARAMS 2-22 
WNDPROC 2-22, 10-1 
WPOINT 2-22 
WRECT 2-22 


X 

XYWINSIZE 2-23 
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